@qodalis/cli-server-abstractions 1.0.0-beta.12

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

@@ -0,0 +1,35 @@
+{
+    "name": "@qodalis/cli-server-abstractions",
+    "version": "1.0.0-beta.12",
+    "description": "Shared interfaces and base classes for Qodalis CLI command processors — zero framework dependencies",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist",
+        "LICENSE",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc"
+    },
+    "keywords": [
+        "cli",
+        "qodalis",
+        "terminal",
+        "commands",
+        "cli-server",
+        "command-processor",
+        "abstractions"
+    ],
+    "author": "Nicolae Lupei <nicolae.lupei@qodalis.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/qodalis-solutions/cli-server-node",
+        "directory": "packages/abstractions"
+    },
+    "homepage": "https://qodalis.com/",
+    "devDependencies": {
+        "typescript": "^5.6.0"
+    }
+}