@qodalis/cli-server-node 1.0.0-beta.4 → 1.0.0-beta.6

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

@@ -33,19 +33,31 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveShellCapabilities = resolveShellCapabilities;
 exports.createCliVersionController = createCliVersionController;
 const express_1 = require("express");
 const os = __importStar(require("os"));
 const SERVER_VERSION = '2.0.0';
-function createCliVersionController() {
+/** Resolves the shell fields of `/capabilities`. */
+function resolveShellCapabilities(options) {
+    return options?.shellCapabilities ? options.shellCapabilities() : { shell: true };
+}
+/**
+ * Creates an Express router for API version discovery and server capabilities.
+ * @returns Router with `/versions` and `/capabilities` endpoints.
+ */
+function createCliVersionController(options) {
     const router = (0, express_1.Router)();
-    router.get('/version', (_req, res) => {
+    router.get('/versions', (_req, res) => {
         res.json({
-            supportedVersions: [1, 2],
-            preferredVersion: 2,
+            supportedVersions: [1],
+            preferredVersion: 1,
             serverVersion: SERVER_VERSION,
         });
     });
+    router.get('/version', (_req, res) => {
+        res.redirect(301, 'versions');
+    });
     router.get('/capabilities', (_req, res) => {
         const detectedOs = os.platform() === 'win32'
             ? 'win32'
@@ -57,10 +69,11 @@ function createCliVersionController() {
             ? 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe'
             : '/bin/bash';
         res.json({
-            shell: true,
+            ...resolveShellCapabilities(options),
             os: detectedOs,
             shellPath,
             version: SERVER_VERSION,
+            streaming: true,
         });
     });
     return router;

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

@@ -1 +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"}
+{"version":3,"file":"cli-version-controller.js","sourceRoot":"","sources":["../../../src/controllers/cli-version-controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,4DAEC;AAMD,gEAqCC;AA/DD,qCAAiC;AACjC,uCAAyB;AAGzB,MAAM,cAAc,GAAG,OAAO,CAAC;AAa/B,oDAAoD;AACpD,SAAgB,wBAAwB,CAAC,OAA6B;IAClE,OAAO,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,SAAgB,0BAA0B,CAAC,OAA6B;IACpE,MAAM,MAAM,GAAG,IAAA,gBAAM,GAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAClC,GAAG,CAAC,IAAI,CAAC;YACL,iBAAiB,EAAE,CAAC,CAAC,CAAC;YACtB,gBAAgB,EAAE,CAAC;YACnB,aAAa,EAAE,cAAc;SAChC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAClC,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,GAAG,wBAAwB,CAAC,OAAO,CAAC;YACpC,EAAE,EAAE,UAAU;YACd,SAAS;YACT,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,IAAI;SAClB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAClB,CAAC"}

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

@@ -1 +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"}
+{"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;AAsB/C;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAmK7E"}

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

@@ -7,6 +7,8 @@ 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");
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('FileSystem');
 /**
  * Maps provider errors to appropriate HTTP status codes and sends a JSON error response.
  */
@@ -34,10 +36,10 @@ function handleError(err, res) {
 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;
+            logger.debug('ls path=%s', dirPath);
             if (!dirPath) {
                 res.status(400).json({ error: 'Missing required query parameter: path' });
                 return;
@@ -46,13 +48,19 @@ function createFilesystemRouter(provider) {
             res.json({ entries });
         }
         catch (err) {
+            if (err instanceof cli_server_plugin_filesystem_1.PermissionDeniedError) {
+                logger.warn('Failed to ls: %s', err.message ?? err);
+            }
+            else {
+                logger.error('Failed to ls: %s', err.message ?? err);
+            }
             handleError(err, res);
         }
     });
-    // ----------------------------------------------------------------- cat
     router.get('/cat', async (req, res) => {
         try {
             const filePath = req.query.path;
+            logger.debug('cat path=%s', filePath);
             if (!filePath) {
                 res.status(400).json({ error: 'Missing required query parameter: path' });
                 return;
@@ -61,13 +69,19 @@ function createFilesystemRouter(provider) {
             res.json({ content });
         }
         catch (err) {
+            if (err instanceof cli_server_plugin_filesystem_1.PermissionDeniedError) {
+                logger.warn('Failed to cat: %s', err.message ?? err);
+            }
+            else {
+                logger.error('Failed to cat: %s', err.message ?? err);
+            }
             handleError(err, res);
         }
     });
-    // ---------------------------------------------------------------- stat
     router.get('/stat', async (req, res) => {
         try {
             const filePath = req.query.path;
+            logger.debug('stat path=%s', filePath);
             if (!filePath) {
                 res.status(400).json({ error: 'Missing required query parameter: path' });
                 return;
@@ -76,13 +90,19 @@ function createFilesystemRouter(provider) {
             res.json(fileStat);
         }
         catch (err) {
+            if (err instanceof cli_server_plugin_filesystem_1.PermissionDeniedError) {
+                logger.warn('Failed to stat: %s', err.message ?? err);
+            }
+            else {
+                logger.error('Failed to stat: %s', err.message ?? err);
+            }
             handleError(err, res);
         }
     });
-    // ------------------------------------------------------------ download
     router.get('/download', async (req, res) => {
         try {
             const filePath = req.query.path;
+            logger.debug('download path=%s', filePath);
             if (!filePath) {
                 res.status(400).json({ error: 'Missing required query parameter: path' });
                 return;
@@ -94,13 +114,19 @@ function createFilesystemRouter(provider) {
             stream.pipe(res);
         }
         catch (err) {
+            if (err instanceof cli_server_plugin_filesystem_1.PermissionDeniedError) {
+                logger.warn('Failed to download: %s', err.message ?? err);
+            }
+            else {
+                logger.error('Failed to download: %s', err.message ?? err);
+            }
             handleError(err, res);
         }
     });
-    // -------------------------------------------------------------- upload
     router.post('/upload', upload.single('file'), async (req, res) => {
         try {
             const targetPath = req.body?.path;
+            logger.debug('upload path=%s', targetPath);
             if (!targetPath) {
                 res.status(400).json({ error: 'Missing required field: path' });
                 return;
@@ -113,13 +139,19 @@ function createFilesystemRouter(provider) {
             res.json({ path: targetPath, size: req.file.size });
         }
         catch (err) {
+            if (err instanceof cli_server_plugin_filesystem_1.PermissionDeniedError) {
+                logger.warn('Failed to upload: %s', err.message ?? err);
+            }
+            else {
+                logger.error('Failed to upload: %s', err.message ?? err);
+            }
             handleError(err, res);
         }
     });
-    // --------------------------------------------------------------- mkdir
     router.post('/mkdir', async (req, res) => {
         try {
             const dirPath = req.body?.path;
+            logger.debug('mkdir path=%s', dirPath);
             if (!dirPath) {
                 res.status(400).json({ error: 'Missing required field: path' });
                 return;
@@ -128,13 +160,19 @@ function createFilesystemRouter(provider) {
             res.json({ path: dirPath });
         }
         catch (err) {
+            if (err instanceof cli_server_plugin_filesystem_1.PermissionDeniedError) {
+                logger.warn('Failed to mkdir: %s', err.message ?? err);
+            }
+            else {
+                logger.error('Failed to mkdir: %s', err.message ?? err);
+            }
             handleError(err, res);
         }
     });
-    // ----------------------------------------------------------------- rm
     router.delete('/rm', async (req, res) => {
         try {
             const targetPath = req.query.path;
+            logger.debug('rm path=%s', targetPath);
             if (!targetPath) {
                 res.status(400).json({ error: 'Missing required query parameter: path' });
                 return;
@@ -143,6 +181,12 @@ function createFilesystemRouter(provider) {
             res.json({ deleted: targetPath });
         }
         catch (err) {
+            if (err instanceof cli_server_plugin_filesystem_1.PermissionDeniedError) {
+                logger.warn('Failed to rm: %s', err.message ?? err);
+            }
+            else {
+                logger.error('Failed to rm: %s', err.message ?? err);
+            }
             handleError(err, res);
         }
     });

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

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

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

@@ -1,12 +1,66 @@
-import { Express } from 'express';
+import { Express, Router } from 'express';
 import cors from 'cors';
-import { CliCommandRegistry, CliEventSocketManager, CliLogSocketManager } from './services';
+import { CliCommandRegistry, CliCommandExecutorService, CliEventSocketManager, CliLogSocketManager } from './services';
 import { CliBuilder } from './extensions';
+import { ICliServerAuth } from './auth/cli-server-auth';
+import { CliShellOptions } from './services/cli-shell-options';
+/**
+ * Generic interface for plugin results that can be auto-mounted.
+ * Plugins expose a `prefix` and `router`; some also have a
+ * `dashboardPrefix` / `dashboardRouter` pair.
+ */
+export interface MountablePlugin {
+    prefix: string;
+    router: Router;
+    dashboardPrefix?: string;
+    dashboardRouter?: Router;
+    /**
+     * Auth provider exposed by the users plugin. Mounting such a plugin
+     * installs it: when `protectServer` is on, every server route and socket
+     * then requires a users session.
+     */
+    serverAuth?: ICliServerAuth;
+    /** Routes that stay public under server protection, as `"METHOD /path"` (e.g. a plugin's login). */
+    publicRoutes?: string[];
+}
+/** Options for creating a standalone CLI server instance. */
 export interface CliServerOptions {
     /** 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 configuration. `true` = permissive (any origin, no credentials),
+     * `false` = disabled, or a cors options object. When omitted, CORS is
+     * enabled only for `allowedOrigins` (disabled if none are set).
+     */
     cors?: boolean | cors.CorsOptions;
+    /**
+     * Origins allowed for CORS and WebSocket upgrades (exact match; `http://host:*`
+     * matches any port). Every WS upgrade with an `Origin` header is checked.
+     */
+    allowedOrigins?: string[];
+    /**
+     * Accept interactive shell WebSocket sessions (default false). When enabled,
+     * access is decided by one mode: users plugin mounted (ticket +
+     * `shell:execute`), `shell.token`, `shell.authorize` or `shell.allowAnonymous`.
+     * With none of them the shell is locked (every connection closed with 4401).
+     */
+    enableShell?: boolean;
+    /** Remote shell security: access mode, limits, timeouts, cwd, shell binary, environment. */
+    shell?: CliShellOptions;
+    /**
+     * Behind reverse proxies: the number of trusted proxy hops (`true` = 1,
+     * `false`/0 = none, the default). The client IP (Express `req.ip`, the
+     * shell's per-address limits) is the `X-Forwarded-For` entry at index
+     * `len - hops` (with one hop, the rightmost entry, appended by the trusted
+     * proxy); the leftmost entry when the list is shorter, the socket address
+     * when the header is absent. `X-Forwarded-Proto`/`-Host` are honoured too.
+     */
+    trustProxy?: boolean | number;
+    /**
+     * Auth provider protecting the whole server (e.g. `usersPlugin.serverAuth`).
+     * Can also be installed later with `setAuth()` or by `mountPlugin(usersPlugin)`.
+     */
+    auth?: ICliServerAuth;
     /** Configure processors via the builder. */
     configure?: (builder: CliBuilder) => void;
 }
@@ -16,11 +70,28 @@ export interface CliServerOptions {
  * Use this for standalone server mode. For integration into an existing
  * Express app, use `createCliController` directly instead.
  */
-export declare function createCliServer(options?: CliServerOptions): {
+export interface CliServerResult {
     app: Express;
     registry: CliCommandRegistry;
     builder: CliBuilder;
+    executor: CliCommandExecutorService;
     eventSocketManager: CliEventSocketManager;
     logSocketManager: CliLogSocketManager;
-};
+    /**
+     * Mount a plugin using its built-in prefix.
+     * Reads `prefix` and `router` from the plugin result, and optionally
+     * `dashboardPrefix` / `dashboardRouter` for plugins that serve a UI.
+     *
+     * @example
+     * ```ts
+     * const result = createCliServer();
+     * result.mountPlugin(jobsPlugin);
+     * result.mountPlugin(adminPlugin);
+     * ```
+     */
+    mountPlugin(plugin: MountablePlugin): void;
+    /** Installs (or removes) the auth provider protecting server routes and sockets. */
+    setAuth(auth: ICliServerAuth | undefined): void;
+}
+export declare function createCliServer(options?: CliServerOptions): CliServerResult;
 //# sourceMappingURL=create-cli-server.d.ts.map

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

@@ -1 +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,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACvH,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;IAC1C,gBAAgB,EAAE,mBAAmB,CAAC;CACzC,CAgDA"}
+{"version":3,"file":"create-cli-server.d.ts","sourceRoot":"","sources":["../../src/create-cli-server.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACvH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C,OAAO,EAAE,cAAc,EAAmD,MAAM,wBAAwB,CAAC;AAEzG,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,oGAAoG;IACpG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAID,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4FAA4F;IAC5F,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,gBAAgB,EAAE,mBAAmB,CAAC;IACtC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,oFAAoF;IACpF,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAAC;CACnD;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA6H/E"}

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

@@ -9,38 +9,76 @@ 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.
- */
+const cli_server_plugin_data_explorer_1 = require("@qodalis/cli-server-plugin-data-explorer");
+const logger_1 = require("./utils/logger");
+const cli_server_auth_1 = require("./auth/cli-server-auth");
+const cli_server_auth_gate_1 = require("./auth/cli-server-auth-gate");
+const logger = (0, logger_1.createLogger)('Server');
 function createCliServer(options = {}) {
-    const { basePath = '/api/qcli', cors: corsOption = true, configure } = options;
+    const { basePath = '/api/qcli', cors: corsOption, configure, allowedOrigins, enableShell = false, shell, trustProxy = false } = options;
+    if (shell && !enableShell) {
+        logger.warn('shell options are set but enableShell is false: the shell stays disabled');
+    }
     const app = (0, express_1.default)();
-    if (corsOption !== false) {
-        app.use((0, cors_1.default)(corsOption === true ? undefined : corsOption));
+    const proxyHops = (0, cli_server_auth_1.trustedProxyHops)(trustProxy);
+    if (proxyHops > 0) {
+        app.set('trust proxy', proxyHops);
+    }
+    if (corsOption === true) {
+        app.use((0, cors_1.default)());
+    }
+    else if (corsOption && typeof corsOption === 'object') {
+        app.use((0, cors_1.default)(corsOption));
     }
-    app.use(express_1.default.json());
+    else if (corsOption === undefined && allowedOrigins && allowedOrigins.length > 0) {
+        // Same-origin requests (e.g. the bundled admin dashboard) are always allowed.
+        app.use((0, cors_1.default)((req, callback) => {
+            const origin = req.headers.origin;
+            callback(null, {
+                origin: (0, cli_server_auth_1.isOriginAllowed)(origin, allowedOrigins) || (0, cli_server_auth_1.isSameOrigin)(origin, req),
+            });
+        }));
+    }
+    app.use(express_1.default.json({ limit: '1mb' }));
+    // Render body-parser failures (malformed JSON, too large) as JSON `{ error }`
+    app.use((err, _req, res, next) => {
+        if (err && (err.type === 'entity.parse.failed' || err.type === 'entity.too.large')) {
+            const status = err.type === 'entity.too.large' ? 413 : 400;
+            res.status(status).json({ error: status === 413 ? 'request body too large' : 'invalid JSON body' });
+            return;
+        }
+        next(err);
+    });
     const registry = new services_1.CliCommandRegistry();
     const builder = new extensions_1.CliBuilder(registry);
+    // Server-wide auth gate (no-op until an auth provider is installed)
+    let serverAuth;
+    const publicRoutes = new Set();
+    app.use((0, cli_server_auth_gate_1.createServerAuthGate)(() => serverAuth, {
+        registry,
+        cliPrefixes: Array.from(new Set(['/api/v1/qcli', (0, cli_server_auth_gate_1.normalizePath)(basePath)])),
+        publicRoutes,
+    }));
     if (configure) {
         configure(builder);
     }
     const executor = new services_1.CliCommandExecutorService(registry);
+    const eventSocketManager = new services_1.CliEventSocketManager({ enableShell, shell, allowedOrigins, trustProxy });
+    const logSocketManager = new services_1.CliLogSocketManager({ allowedOrigins, trustProxy });
+    const shellCapabilities = () => {
+        const mode = eventSocketManager.shellAuthMode;
+        return mode ? { shell: true, shellAuth: mode } : { shell: false };
+    };
     // Version discovery endpoint
-    app.use('/api/qcli', (0, cli_version_controller_1.createCliVersionController)());
+    app.use('/api/qcli', (0, cli_version_controller_1.createCliVersionController)({ shellCapabilities }));
     // 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));
+    app.use('/api/v1/qcli', (0, cli_controller_1.createCliController)(registry, executor, { shellCapabilities }));
     // 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));
+    if (basePath !== '/api/v1/qcli') {
+        app.use(basePath, (0, cli_controller_1.createCliController)(registry, executor, { shellCapabilities }));
     }
     // Filesystem API — provider-based
     let fsProvider = builder.fileStorageProvider;
@@ -51,8 +89,38 @@ function createCliServer(options = {}) {
     if (fsProvider) {
         app.use('/api/qcli/fs', (0, filesystem_controller_1.createFilesystemRouter)(fsProvider));
     }
-    const eventSocketManager = new services_1.CliEventSocketManager();
-    const logSocketManager = new services_1.CliLogSocketManager();
-    return { app, registry, builder, eventSocketManager, logSocketManager };
+    // Data Explorer API
+    const deBuilder = builder.dataExplorerBuilder;
+    if (deBuilder && deBuilder.registry.size > 0) {
+        const deExecutor = new cli_server_plugin_data_explorer_1.DataExplorerExecutor(deBuilder.registry);
+        app.use('/api/qcli/data-explorer', (0, cli_server_plugin_data_explorer_1.createDataExplorerController)(deBuilder.registry, deExecutor));
+    }
+    logger.info('CLI server created with %d processors', registry.processors.length);
+    const setAuth = (auth) => {
+        serverAuth = auth;
+        eventSocketManager.setAuth(auth);
+        logSocketManager.setAuth(auth);
+        auth?.attachToServer?.({
+            allowedOrigins,
+            broadcast: (msg) => eventSocketManager.broadcastMessage(msg),
+        });
+    };
+    if (options.auth) {
+        setAuth(options.auth);
+    }
+    const mountPlugin = (plugin) => {
+        for (const route of plugin.publicRoutes ?? []) {
+            const [method, ...rest] = route.trim().split(/\s+/);
+            publicRoutes.add(`${method.toUpperCase()} ${(0, cli_server_auth_gate_1.normalizePath)(rest.join(' '))}`);
+        }
+        if (plugin.serverAuth && plugin.serverAuth !== serverAuth) {
+            setAuth(plugin.serverAuth);
+        }
+        app.use(plugin.prefix, plugin.router);
+        if (plugin.dashboardPrefix && plugin.dashboardRouter) {
+            app.use(plugin.dashboardPrefix, plugin.dashboardRouter);
+        }
+    };
+    return { app, registry, builder, executor, eventSocketManager, logSocketManager, mountPlugin, setAuth };
 }
 //# sourceMappingURL=create-cli-server.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"create-cli-server.js","sourceRoot":"","sources":["../../src/create-cli-server.ts"],"names":[],"mappings":";;;;;AAyBA,0CAsDC;AA/ED,sDAA2C;AAC3C,gDAAwB;AACxB,yCAAuH;AACvH,6CAA0C;AAC1C,iEAAmE;AACnE,uEAAwE;AACxE,iFAAkF;AAClF,+EAA6E;AAC7E,wFAA8E;AAW9E;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,UAA4B,EAAE;IAO1D,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;IACvD,MAAM,gBAAgB,GAAG,IAAI,8BAAmB,EAAE,CAAC;IAEnD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;AAC5E,CAAC"}
+{"version":3,"file":"create-cli-server.js","sourceRoot":"","sources":["../../src/create-cli-server.ts"],"names":[],"mappings":"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"}

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

@@ -1,20 +1,38 @@
-import { ICliCommandProcessor, ICliModule } from '../abstractions';
+import { ICliCommandProcessor, ICliModule, IDataExplorerProvider, DataExplorerProviderOptions } from '../abstractions';
 import { FileSystemOptions } from '../filesystem';
 import { IFileStorageProvider } from '@qodalis/cli-server-plugin-filesystem';
+import { DataExplorerBuilder, DataExplorerProviderFactory } from '@qodalis/cli-server-plugin-data-explorer';
 import { CliCommandRegistry } from '../services';
+/**
+ * Fluent builder for configuring CLI server processors, modules, filesystem, and data explorer providers.
+ * Passed to the `configure` callback in {@link CliServerOptions}.
+ */
 export declare class CliBuilder {
     private readonly _registry;
     private readonly _modules;
     private _fileSystemOptions?;
     private _fileStorageProvider?;
+    private _dataExplorerBuilder?;
     constructor(registry: CliCommandRegistry);
+    /** Registers a single command processor. */
     addProcessor(processor: ICliCommandProcessor): CliBuilder;
+    /** Registers a module and all of its command processors. */
     addModule(module: ICliModule): CliBuilder;
+    /** Returns all registered modules. */
     get modules(): ReadonlyArray<ICliModule>;
+    /** Configures the filesystem API with path-based access control. */
     addFileSystem(options: FileSystemOptions): CliBuilder;
+    /** Returns the underlying command registry. */
     get registry(): CliCommandRegistry;
+    /** Sets a custom file storage provider for the filesystem API. */
     setFileStorageProvider(provider: IFileStorageProvider): CliBuilder;
+    /** Returns the configured filesystem options, if any. */
     get fileSystemOptions(): FileSystemOptions | undefined;
+    /** Returns the configured file storage provider, if any. */
     get fileStorageProvider(): IFileStorageProvider | undefined;
+    /** Registers a data explorer provider with its configuration options. */
+    addDataExplorerProvider(providerOrFactory: IDataExplorerProvider | DataExplorerProviderFactory, options: DataExplorerProviderOptions): CliBuilder;
+    /** Returns the data explorer builder, if any providers have been registered. */
+    get dataExplorerBuilder(): DataExplorerBuilder | undefined;
 }
 //# sourceMappingURL=cli-builder.d.ts.map

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

@@ -1 +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,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,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;IAQzC,IAAI,OAAO,IAAI,aAAa,CAAC,UAAU,CAAC,CAEvC;IAED,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"}
+{"version":3,"file":"cli-builder.d.ts","sourceRoot":"","sources":["../../../src/extensions/cli-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACvH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,kBAAkB,CAAC,CAAoB;IAC/C,OAAO,CAAC,oBAAoB,CAAC,CAAuB;IACpD,OAAO,CAAC,oBAAoB,CAAC,CAAsB;gBAEvC,QAAQ,EAAE,kBAAkB;IAIxC,4CAA4C;IAC5C,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,UAAU;IAKzD,4DAA4D;IAC5D,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU;IAQzC,sCAAsC;IACtC,IAAI,OAAO,IAAI,aAAa,CAAC,UAAU,CAAC,CAEvC;IAED,oEAAoE;IACpE,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU;IAKrD,+CAA+C;IAC/C,IAAI,QAAQ,IAAI,kBAAkB,CAEjC;IAED,kEAAkE;IAClE,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,UAAU;IAKlE,yDAAyD;IACzD,IAAI,iBAAiB,IAAI,iBAAiB,GAAG,SAAS,CAErD;IAED,4DAA4D;IAC5D,IAAI,mBAAmB,IAAI,oBAAoB,GAAG,SAAS,CAE1D;IAED,yEAAyE;IACzE,uBAAuB,CACnB,iBAAiB,EAAE,qBAAqB,GAAG,2BAA2B,EACtE,OAAO,EAAE,2BAA2B,GACrC,UAAU;IAQb,gFAAgF;IAChF,IAAI,mBAAmB,IAAI,mBAAmB,GAAG,SAAS,CAEzD;CACJ"}

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

@@ -1,18 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliBuilder = void 0;
+const cli_server_plugin_data_explorer_1 = require("@qodalis/cli-server-plugin-data-explorer");
+/**
+ * Fluent builder for configuring CLI server processors, modules, filesystem, and data explorer providers.
+ * Passed to the `configure` callback in {@link CliServerOptions}.
+ */
 class CliBuilder {
     _registry;
     _modules = [];
     _fileSystemOptions;
     _fileStorageProvider;
+    _dataExplorerBuilder;
     constructor(registry) {
         this._registry = registry;
     }
+    /** Registers a single command processor. */
     addProcessor(processor) {
         this._registry.register(processor);
         return this;
     }
+    /** Registers a module and all of its command processors. */
     addModule(module) {
         this._modules.push(module);
         for (const processor of module.processors) {
@@ -20,26 +28,44 @@ class CliBuilder {
         }
         return this;
     }
+    /** Returns all registered modules. */
     get modules() {
         return this._modules;
     }
+    /** Configures the filesystem API with path-based access control. */
     addFileSystem(options) {
         this._fileSystemOptions = options;
         return this;
     }
+    /** Returns the underlying command registry. */
     get registry() {
         return this._registry;
     }
+    /** Sets a custom file storage provider for the filesystem API. */
     setFileStorageProvider(provider) {
         this._fileStorageProvider = provider;
         return this;
     }
+    /** Returns the configured filesystem options, if any. */
     get fileSystemOptions() {
         return this._fileSystemOptions;
     }
+    /** Returns the configured file storage provider, if any. */
     get fileStorageProvider() {
         return this._fileStorageProvider;
     }
+    /** Registers a data explorer provider with its configuration options. */
+    addDataExplorerProvider(providerOrFactory, options) {
+        if (!this._dataExplorerBuilder) {
+            this._dataExplorerBuilder = new cli_server_plugin_data_explorer_1.DataExplorerBuilder();
+        }
+        this._dataExplorerBuilder.addProvider(providerOrFactory, options);
+        return this;
+    }
+    /** Returns the data explorer builder, if any providers have been registered. */
+    get dataExplorerBuilder() {
+        return this._dataExplorerBuilder;
+    }
 }
 exports.CliBuilder = CliBuilder;
 //# sourceMappingURL=cli-builder.js.map