@qodalis/cli-server-abstractions 1.0.0-beta.6 → 1.0.0-beta.8

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

@@ -14,6 +14,11 @@ export interface ICliCommandProcessor {
     allowUnlistedCommands?: boolean;
     /** When true, the command requires a positional value argument. */
     valueRequired?: boolean;
+    /**
+     * When true, the command reads an optional positional value (`command.value`).
+     * Implied by {@link valueRequired}. MCP exposes it as an optional `value` argument.
+     */
+    acceptsValue?: boolean;
     /** Semantic version of this processor. */
     version: string;
     /** Nested sub-command processors. */
@@ -51,6 +56,7 @@ export declare abstract class CliCommandProcessor implements ICliCommandProcesso
     author: ICliCommandAuthor;
     allowUnlistedCommands?: boolean;
     valueRequired?: boolean;
+    acceptsValue?: boolean;
     version: string;
     processors?: ICliCommandProcessor[];
     parameters?: ICliCommandParameterDescriptor[];

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

@@ -1 +1 @@
-{"version":3,"file":"cli-command-processor.d.ts","sourceRoot":"","sources":["../src/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;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACjC,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gGAAgG;IAChG,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mEAAmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC9C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5G;AAED;;;GAGG;AACH,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;IAC9C,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IACvF,qBAAqB,CAAC,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAC3G"}
+{"version":3,"file":"cli-command-processor.d.ts","sourceRoot":"","sources":["../src/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;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACjC,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gGAAgG;IAChG,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mEAAmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC9C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5G;AAED;;;GAGG;AACH,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,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAW;IAC1B,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC9C,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IACvF,qBAAqB,CAAC,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAC3G"}

package/dist/cli-command-processor.js

@@ -10,6 +10,7 @@ class CliCommandProcessor {
     author = cli_command_author_1.DefaultLibraryAuthor;
     allowUnlistedCommands;
     valueRequired;
+    acceptsValue;
     version = '1.0.0';
     processors;
     parameters;

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

@@ -1 +1 @@
-{"version":3,"file":"cli-command-processor.js","sourceRoot":"","sources":["../src/cli-command-processor.ts"],"names":[],"mappings":";;;AAAA,6DAA+E;AA6C/E;;;GAGG;AACH,MAAsB,mBAAmB;IAGrC,MAAM,GAAsB,yCAAoB,CAAC;IACjD,qBAAqB,CAAW;IAChC,aAAa,CAAW;IACxB,OAAO,GAAW,OAAO,CAAC;IAC1B,UAAU,CAA0B;IACpC,UAAU,CAAoC;IAC9C,mBAAmB,CAAY;CAIlC;AAbD,kDAaC"}
+{"version":3,"file":"cli-command-processor.js","sourceRoot":"","sources":["../src/cli-command-processor.ts"],"names":[],"mappings":";;;AAAA,6DAA+E;AAkD/E;;;GAGG;AACH,MAAsB,mBAAmB;IAGrC,MAAM,GAAsB,yCAAoB,CAAC;IACjD,qBAAqB,CAAW;IAChC,aAAa,CAAW;IACxB,YAAY,CAAW;IACvB,OAAO,GAAW,OAAO,CAAC;IAC1B,UAAU,CAA0B;IACpC,UAAU,CAAoC;IAC9C,mBAAmB,CAAY;CAIlC;AAdD,kDAcC"}

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

@@ -10,6 +10,13 @@ export interface CliProcessCommand {
     rawCommand: string;
     /** Positional value argument (the first non-flag token after the command). */
     value?: string;
+    /**
+     * The positional arguments after the command and sub-command words, split
+     * like a shell: quotes removed, backslash escapes applied, flags excluded.
+     * Sent by newer browsers; `value` stays as typed. Read it with `getPositionals`,
+     * which falls back to splitting `value` when it is missing.
+     */
+    positionals?: string[];
     /** Named arguments parsed from flags (e.g. { algorithm: "sha256" }). */
     args: Record<string, any>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"cli-process-command.d.ts","sourceRoot":"","sources":["../src/cli-process-command.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAC9B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,6FAA6F;IAC7F,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"cli-process-command.d.ts","sourceRoot":"","sources":["../src/cli-process-command.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAC9B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,6FAA6F;IAC7F,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { ICliCommandAuthor, CliCommandAuthor, DefaultLibraryAuthor } from './cli-command-author';
 export { CliProcessCommand } from './cli-process-command';
+export { splitShellWords, joinShellWords, getPositionals, getPositionalText, quoteShellWord } from './shell-words';
 export { ICliCommandParameterDescriptor, CliCommandParameterDescriptor } from './cli-command-parameter-descriptor';
 export { ICliCommandProcessor, CliCommandProcessor } from './cli-command-processor';
 export { ICliModule, CliModule } from './cli-module';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/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;AACpF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EACH,OAAO,EACP,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,GACd,MAAM,QAAQ,CAAC;AAChB,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/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,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnH,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EACH,OAAO,EACP,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,GACd,MAAM,QAAQ,CAAC;AAChB,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isStreamCapable = exports.DataExplorerOutputFormat = exports.DataExplorerLanguage = exports.CliModule = exports.CliCommandProcessor = exports.CliCommandParameterDescriptor = exports.DefaultLibraryAuthor = exports.CliCommandAuthor = void 0;
+exports.isStreamCapable = exports.DataExplorerOutputFormat = exports.DataExplorerLanguage = exports.CliModule = exports.CliCommandProcessor = exports.CliCommandParameterDescriptor = exports.quoteShellWord = exports.getPositionalText = exports.getPositionals = exports.joinShellWords = exports.splitShellWords = 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 shell_words_1 = require("./shell-words");
+Object.defineProperty(exports, "splitShellWords", { enumerable: true, get: function () { return shell_words_1.splitShellWords; } });
+Object.defineProperty(exports, "joinShellWords", { enumerable: true, get: function () { return shell_words_1.joinShellWords; } });
+Object.defineProperty(exports, "getPositionals", { enumerable: true, get: function () { return shell_words_1.getPositionals; } });
+Object.defineProperty(exports, "getPositionalText", { enumerable: true, get: function () { return shell_words_1.getPositionalText; } });
+Object.defineProperty(exports, "quoteShellWord", { enumerable: true, get: function () { return shell_words_1.quoteShellWord; } });
 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");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/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;AAClD,2CAAqD;AAAhC,uGAAA,SAAS,OAAA;AAgB9B,6DAa+B;AAZ3B,2HAAA,oBAAoB,OAAA;AACpB,+HAAA,wBAAwB,OAAA;AAc5B,+EAA6F;AAAxD,+HAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiG;AAArE,sHAAA,gBAAgB,OAAA;AAAE,0HAAA,oBAAoB,OAAA;AAElE,6CAAmH;AAA1G,8GAAA,eAAe,OAAA;AAAE,6GAAA,cAAc,OAAA;AAAE,6GAAA,cAAc,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAAE,6GAAA,cAAc,OAAA;AAC3F,uFAAmH;AAA1E,iJAAA,6BAA6B,OAAA;AACtE,iEAAoF;AAArD,4HAAA,mBAAmB,OAAA;AAClD,2CAAqD;AAAhC,uGAAA,SAAS,OAAA;AAgB9B,6DAa+B;AAZ3B,2HAAA,oBAAoB,OAAA;AACpB,+HAAA,wBAAwB,OAAA;AAc5B,+EAA6F;AAAxD,+HAAA,eAAe,OAAA"}

package/dist/shell-words.d.ts

@@ -0,0 +1,31 @@
+import { CliProcessCommand } from './cli-process-command';
+/**
+ * Splits text into words like a shell, as the browser CLI does: whitespace
+ * separates words, quotes are removed (`"a b"` is one word `a b`), a backslash
+ * outside quotes escapes the next character (`my\ file` -> `my file`), and
+ * inside double quotes `\"` and `\\` are escapes. Single quotes keep their
+ * content as is. A quote without a closing one is text.
+ */
+export declare function splitShellWords(text: string): string[];
+/**
+ * The arguments as a shell's echo prints them, as the browser CLI's own
+ * `echo` does: quotes removed, the words joined by one space, spacing inside
+ * quotes kept (`"a" "b"` -> `a b`). A quote without a closing one is text.
+ */
+export declare function joinShellWords(text: string): string;
+/**
+ * The positional arguments of a command, unquoted: `command.positionals` as the
+ * browser sends it, or, from clients that do not send it, `command.value`
+ * split with the same shell rules.
+ */
+export declare function getPositionals(command: Pick<CliProcessCommand, 'positionals' | 'value'>): string[];
+/** The positional arguments joined by one space (`base64 encode "a b"` -> `a b`); empty when there are none. */
+export declare function getPositionalText(command: Pick<CliProcessCommand, 'positionals' | 'value'>): string;
+/**
+ * Quotes a word for a command line so `splitShellWords` (and the browser CLI's
+ * parser) reads it back unchanged: as is when it has no spaces, quotes or
+ * special characters; in double quotes when it has no `"`; in single quotes
+ * when it has no `'`; otherwise in double quotes with `\"` and `\\` escapes.
+ */
+export declare function quoteShellWord(value: string): string;
+//# sourceMappingURL=shell-words.d.ts.map

package/dist/shell-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-words.d.ts","sourceRoot":"","sources":["../src/shell-words.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAe1D;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BtD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,MAAM,EAAE,CAGlG;AAED,gHAAgH;AAChH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,MAAM,CAEnG;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/shell-words.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitShellWords = splitShellWords;
+exports.joinShellWords = joinShellWords;
+exports.getPositionals = getPositionals;
+exports.getPositionalText = getPositionalText;
+exports.quoteShellWord = quoteShellWord;
+/** Index of the quote closing the one at `start`, or -1. In double quotes `\"` and `\\` are escapes. */
+function closingQuote(text, start) {
+    const quote = text[start];
+    for (let i = start + 1; i < text.length; i++) {
+        if (quote === '"' && text[i] === '\\' && (text[i + 1] === '"' || text[i + 1] === '\\')) {
+            i++;
+        }
+        else if (text[i] === quote) {
+            return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Splits text into words like a shell, as the browser CLI does: whitespace
+ * separates words, quotes are removed (`"a b"` is one word `a b`), a backslash
+ * outside quotes escapes the next character (`my\ file` -> `my file`), and
+ * inside double quotes `\"` and `\\` are escapes. Single quotes keep their
+ * content as is. A quote without a closing one is text.
+ */
+function splitShellWords(text) {
+    const words = [];
+    let current = '';
+    let inWord = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '\\' && i + 1 < text.length) {
+            current += text[++i];
+            inWord = true;
+            continue;
+        }
+        const end = ch === '"' || ch === "'" ? closingQuote(text, i) : -1;
+        if (end !== -1) {
+            const inner = text.slice(i + 1, end);
+            current += ch === '"' ? inner.replace(/\\(["\\])/g, '$1') : inner;
+            inWord = true;
+            i = end;
+        }
+        else if (/\s/.test(ch)) {
+            if (inWord)
+                words.push(current);
+            current = '';
+            inWord = false;
+        }
+        else {
+            current += ch;
+            inWord = true;
+        }
+    }
+    if (inWord)
+        words.push(current);
+    return words;
+}
+/**
+ * The arguments as a shell's echo prints them, as the browser CLI's own
+ * `echo` does: quotes removed, the words joined by one space, spacing inside
+ * quotes kept (`"a" "b"` -> `a b`). A quote without a closing one is text.
+ */
+function joinShellWords(text) {
+    return splitShellWords(text).join(' ');
+}
+/**
+ * The positional arguments of a command, unquoted: `command.positionals` as the
+ * browser sends it, or, from clients that do not send it, `command.value`
+ * split with the same shell rules.
+ */
+function getPositionals(command) {
+    if (Array.isArray(command.positionals))
+        return command.positionals.map((p) => String(p));
+    return splitShellWords(command.value ?? '');
+}
+/** The positional arguments joined by one space (`base64 encode "a b"` -> `a b`); empty when there are none. */
+function getPositionalText(command) {
+    return getPositionals(command).join(' ');
+}
+/**
+ * Quotes a word for a command line so `splitShellWords` (and the browser CLI's
+ * parser) reads it back unchanged: as is when it has no spaces, quotes or
+ * special characters; in double quotes when it has no `"`; in single quotes
+ * when it has no `'`; otherwise in double quotes with `\"` and `\\` escapes.
+ */
+function quoteShellWord(value) {
+    if (/^[^\s"'\\=|&;<>()$`*?#~-][^\s"'\\=|&;<>()$`*?#~]*$/.test(value))
+        return value;
+    if (!value.includes('"'))
+        return `"${value.replace(/\\/g, '\\\\')}"`;
+    if (!value.includes("'"))
+        return `'${value}'`;
+    return `"${value.replace(/[\\"]/g, '\\$&')}"`;
+}
+//# sourceMappingURL=shell-words.js.map

package/dist/shell-words.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@qodalis/cli-server-abstractions",
-    "version": "1.0.0-beta.6",
+    "version": "1.0.0-beta.8",
     "description": "Shared interfaces and base classes for Qodalis CLI command processors — zero framework dependencies",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",