@rogatio/cli 6.13.0 → 6.14.1

package/README.md

@@ -42,7 +42,7 @@ rogatio <command> [options]
 | `rogatio test [path] [url...]` | Run offline dry-run tests. Any filename is accepted; the default is `.rogatio.json` in the current directory. |
 | `rogatio ai <setup\|ls\|show\|delete\|test>` | AI provider configuration. `setup` interactive; `ls` list; `show` redacted; `delete` remove; `test` connection. |
 | `rogatio runtime <install\|uninstall\|verify>` | Register the native-messaging host with `install` and trust the device-local CA in one **transactional** call; it needs elevated privileges (Linux `sudo`, macOS keychain authorization, Windows Administrator) and rolls back with exit `1` and `trust unsupported: <reasons>` when a capability or elevation is missing. Release users never pass `--extension-id`. That flag is only for development (a local unpacked build without the release key) and for forks. `uninstall` removes the host manifest, the device-local CA files, and the CA trust installation (idempotent). `verify` reports whether manifest, `runtime-host` wrapper, allowed origins, and CA trust are all valid, and fails when `allowed_origins` omits the release ID. Release users never pass `--extension-id` on verify either. |
-| `rogatio runtime host [path]` | Run the consolidated native-messaging host for the project (pair/authorize/body transforms over stdio). Normally launched by the browser; run manually only for debugging. `--root <dir>` overrides the confined file root; `--mock-port <n>` binds the loopback mock-response faucet. |
+| `rogatio runtime host [path]` | Run the consolidated native-messaging host for the project (pair/authorize/body transforms and mock responses over stdio). Normally launched by the browser; run manually only for debugging. `--root <dir>` overrides the confined mock file root. When omitted, a saved device-local root for that project file is used, otherwise the project directory. A stdin project that contains a file mock requires `--root`. |
 
 Global options: `--help, -h` and `--version, -v`. Run `rogatio <command> --help`
 for command-specific usage.

package/dist/editor/index.css

@@ -375,6 +375,35 @@
   font-weight: 600;
   font-size: 0.8125rem;
 }
+.rogatio-editor [data-mock-file-root] {
+  display: grid;
+  gap: 0.45rem;
+  min-width: 0;
+}
+.rogatio-editor [data-mock-file-root] > span {
+  font-weight: 600;
+}
+.rogatio-editor [data-mock-file-root-hint] {
+  color: var(--rogatio-muted);
+  font-size: 0.8125rem;
+}
+.rogatio-editor [data-mock-file-root-value] {
+  font-family: var(--rogatio-font-mono);
+  font-size: 0.8125rem;
+}
+.rogatio-editor [data-mock-file-root] p {
+  margin: 0;
+}
+.rogatio-editor [data-mock-file-root-actions] {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+}
+.rogatio-editor [data-mock-file-root-error] {
+  color: var(--rogatio-danger);
+  font-weight: 600;
+  font-size: 0.8125rem;
+}
 .rogatio-editor [data-editor-origin-row] {
   display: grid;
   grid-template-columns: minmax(0, 1fr) auto;

package/dist/editor/index.js

@@ -909,16 +909,260 @@ function createHeaderRuleType() {
   };
 }
 
+// packages/editor/src/rule-types/mock.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asMockAction(value) {
+  if (!isRecord(value) || typeof value.status !== "number") return void 0;
+  const action = value;
+  if (action.headers !== void 0 && !Array.isArray(action.headers)) {
+    return void 0;
+  }
+  return action;
+}
+function compact(action) {
+  const next = {};
+  for (const [key, value] of Object.entries(action)) {
+    if (value !== void 0) next[key] = value;
+  }
+  return next;
+}
+function createMockRuleType() {
+  return {
+    id: "mock",
+    label: "Mock response",
+    actionField: "mock",
+    matches(rule) {
+      const type = rule.type;
+      if (type === "mock") return true;
+      if (type !== void 0) return false;
+      return asMockAction(rule.mock) !== void 0;
+    },
+    // Validation is owned by the host-supplied `validate` adapter (schema and
+    // semantic rules, including the 204/205/304 status ban). This extension adds
+    // no editor-local policy; mount() registers controls at the `/mock/...`
+    // paths so host diagnostics land on the matching fields.
+    validate() {
+      return [];
+    },
+    mount(context) {
+      const { document: document2, container } = context;
+      const getCurrent = () => asMockAction(context.getField("mock"));
+      const setAction = (next) => {
+        context.setField("mock", compact(next));
+      };
+      const render = () => {
+        const current = getCurrent();
+        container.replaceChildren();
+        if (current === void 0) return;
+        const statusLabel = document2.createElement("label");
+        statusLabel.textContent = "Status";
+        const statusInput = document2.createElement("input");
+        statusInput.type = "number";
+        statusInput.min = String(LIMITS.minMockStatus);
+        statusInput.max = String(LIMITS.maxMockStatus);
+        statusInput.step = "1";
+        statusInput.value = String(current.status);
+        statusInput.dataset.editorField = "true";
+        statusInput.addEventListener("input", () => {
+          const c = getCurrent();
+          if (c === void 0) return;
+          setAction({ ...c, status: Number(statusInput.value) });
+        });
+        context.registerControl("/mock/status", statusInput);
+        statusLabel.append(statusInput);
+        const delayLabel = document2.createElement("label");
+        delayLabel.textContent = "Delay (ms)";
+        const delayInput = document2.createElement("input");
+        delayInput.type = "number";
+        delayInput.min = "0";
+        delayInput.max = String(LIMITS.maxMockDelayMs);
+        delayInput.step = "1";
+        delayInput.value = current.delayMs === void 0 ? "" : String(current.delayMs);
+        delayInput.dataset.editorField = "true";
+        delayInput.addEventListener("input", () => {
+          const c = getCurrent();
+          if (c === void 0) return;
+          const raw = delayInput.value;
+          const next = raw === "" ? { ...c, delayMs: void 0 } : { ...c, delayMs: Number(raw) };
+          setAction(next);
+        });
+        context.registerControl("/mock/delayMs", delayInput);
+        delayLabel.append(delayInput);
+        const sourceLabel = document2.createElement("label");
+        sourceLabel.textContent = "Body source";
+        const sourceSelect = document2.createElement("select");
+        sourceSelect.dataset.editorField = "true";
+        const bodyOption = document2.createElement("option");
+        bodyOption.value = "body";
+        bodyOption.textContent = "Inline body";
+        const fileOption = document2.createElement("option");
+        fileOption.value = "file";
+        fileOption.textContent = "File snapshot";
+        sourceSelect.append(bodyOption, fileOption);
+        sourceSelect.value = typeof current.file === "string" ? "file" : "body";
+        context.registerControl("/mock", sourceSelect);
+        sourceLabel.append(sourceSelect);
+        const bodyArea = document2.createElement("textarea");
+        bodyArea.value = typeof current.body === "string" ? current.body : "";
+        bodyArea.dataset.editorField = "true";
+        bodyArea.setAttribute("aria-label", "Body");
+        bodyArea.addEventListener("input", () => {
+          const c = getCurrent();
+          if (c === void 0) return;
+          setAction({ ...c, body: bodyArea.value, file: void 0 });
+        });
+        context.registerControl("/mock/body", bodyArea);
+        const fileLabel = document2.createElement("label");
+        fileLabel.textContent = "File path";
+        const fileInput = document2.createElement("input");
+        fileInput.type = "text";
+        fileInput.value = typeof current.file === "string" ? current.file : "";
+        fileInput.dataset.editorField = "true";
+        fileInput.addEventListener("input", () => {
+          const c = getCurrent();
+          if (c === void 0) return;
+          setAction({ ...c, body: void 0, file: fileInput.value });
+        });
+        context.registerControl("/mock/file", fileInput);
+        fileLabel.append(fileInput);
+        const syncSource = () => {
+          const useFile = sourceSelect.value === "file";
+          bodyArea.hidden = useFile;
+          fileLabel.hidden = !useFile;
+        };
+        sourceSelect.addEventListener("change", () => {
+          const c = getCurrent();
+          if (c === void 0) return;
+          if (sourceSelect.value === "file") {
+            setAction({
+              ...c,
+              body: void 0,
+              file: typeof c.file === "string" ? c.file : ""
+            });
+          } else {
+            setAction({
+              ...c,
+              file: void 0,
+              body: typeof c.body === "string" ? c.body : ""
+            });
+          }
+          syncSource();
+        });
+        syncSource();
+        const headersFieldset = document2.createElement("fieldset");
+        const headersLegend = document2.createElement("legend");
+        headersLegend.textContent = "Response headers";
+        headersFieldset.append(headersLegend);
+        const renderHeaders = () => {
+          const c = getCurrent();
+          if (c === void 0) return;
+          headersFieldset.querySelectorAll("[data-mock-header-row]").forEach((row) => {
+            row.remove();
+          });
+          headersFieldset.querySelectorAll("[data-mock-add-header]").forEach((button) => {
+            button.remove();
+          });
+          const headers = c.headers ?? [];
+          headers.forEach((header, index) => {
+            const row = document2.createElement("div");
+            row.dataset.mockHeaderRow = String(index);
+            const nameLabel = document2.createElement("label");
+            nameLabel.textContent = "Name";
+            const nameInput = document2.createElement("input");
+            nameInput.type = "text";
+            nameInput.value = header.name;
+            nameInput.dataset.editorField = "true";
+            nameInput.addEventListener("input", () => {
+              const cc = getCurrent();
+              if (cc === void 0) return;
+              const next = (cc.headers ?? []).map(
+                (entry, itemIndex) => itemIndex === index ? { ...entry, name: nameInput.value } : entry
+              );
+              setAction({ ...cc, headers: next });
+            });
+            context.registerControl(`/mock/headers/${index}/name`, nameInput);
+            nameLabel.append(nameInput);
+            const valueLabel = document2.createElement("label");
+            valueLabel.textContent = "Value";
+            const valueInput = document2.createElement("input");
+            valueInput.type = "text";
+            valueInput.value = header.value;
+            valueInput.dataset.editorField = "true";
+            valueInput.addEventListener("input", () => {
+              const cc = getCurrent();
+              if (cc === void 0) return;
+              const next = (cc.headers ?? []).map(
+                (entry, itemIndex) => itemIndex === index ? { ...entry, value: valueInput.value } : entry
+              );
+              setAction({ ...cc, headers: next });
+            });
+            context.registerControl(`/mock/headers/${index}/value`, valueInput);
+            valueLabel.append(valueInput);
+            const remove = document2.createElement("button");
+            remove.type = "button";
+            remove.textContent = "Remove";
+            remove.dataset.editorField = "true";
+            remove.addEventListener("click", () => {
+              const cc = getCurrent();
+              if (cc === void 0) return;
+              const next = (cc.headers ?? []).filter(
+                (_, itemIndex) => itemIndex !== index
+              );
+              setAction({
+                ...cc,
+                headers: next.length > 0 ? next : void 0
+              });
+            });
+            row.append(nameLabel, valueLabel, remove);
+            headersFieldset.append(row);
+          });
+          const add = document2.createElement("button");
+          add.type = "button";
+          add.textContent = "Add header";
+          add.dataset.editorField = "true";
+          add.dataset.mockAddHeader = "true";
+          add.addEventListener("click", () => {
+            const cc = getCurrent();
+            if (cc === void 0) return;
+            setAction({
+              ...cc,
+              headers: [...cc.headers ?? [], { name: "", value: "" }]
+            });
+          });
+          headersFieldset.append(add);
+        };
+        renderHeaders();
+        container.append(
+          statusLabel,
+          delayLabel,
+          sourceLabel,
+          bodyArea,
+          fileLabel,
+          headersFieldset
+        );
+      };
+      render();
+      return { destroy() {
+      } };
+    },
+    defaultAction() {
+      return { status: 200, body: "" };
+    }
+  };
+}
+
 // packages/editor/src/rule-types/query.ts
 var MAX_QUERY_NAME_LENGTH = 256;
 var MAX_QUERY_VALUE_LENGTH = 2048;
 var MAX_QUERY_PARAMS = 64;
 var QUERY_OPERATIONS = Object.freeze(["set", "remove"]);
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function asQueryAction(value) {
-  if (!isRecord(value)) return void 0;
+  if (!isRecord2(value)) return void 0;
   if (value.type !== "query") return void 0;
   const params = value.params;
   if (!Array.isArray(params)) return void 0;
@@ -1193,11 +1437,11 @@ function createRedirectRuleType() {
 }
 
 // packages/editor/src/rule-types/request-body.ts
-function isRecord2(value) {
+function isRecord3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function requestBodyOf(value) {
-  if (!isRecord2(value) || !("mode" in value)) return void 0;
+  if (!isRecord3(value) || !("mode" in value)) return void 0;
   return value;
 }
 function stable2(values) {
@@ -1389,11 +1633,11 @@ function createRequestBodyRuleType() {
 }
 
 // packages/editor/src/rule-types/response-body.ts
-function isRecord3(value) {
+function isRecord4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function responseBodyOf(value) {
-  if (!isRecord3(value)) return void 0;
+  if (!isRecord4(value)) return void 0;
   if (value.mode === "replace") {
     return { mode: "replace", body: value.body };
   }
@@ -1462,7 +1706,7 @@ function createResponseBodyRuleType() {
     },
     validate(rule, rulePath) {
       const raw = rule.responseBody;
-      if (isRecord3(raw) && "mode" in raw && raw.mode !== "replace" && raw.mode !== "regex") {
+      if (isRecord4(raw) && "mode" in raw && raw.mode !== "replace" && raw.mode !== "regex") {
         return stable3([
           {
             code: "editor.response-body-mode",
@@ -1474,7 +1718,7 @@ function createResponseBodyRuleType() {
       }
       const action = responseBodyOf(raw);
       if (action === void 0) {
-        if (isRecord3(raw) && raw.mode === "regex") {
+        if (isRecord4(raw) && raw.mode === "regex") {
           return stable3(validateRegexReplacements([], rulePath));
         }
         return [];
@@ -1612,7 +1856,7 @@ function createResponseBodyRuleType() {
         } else {
           const stored = context.getField("responseBody");
           const writeRegex = (replacements) => {
-            if (isRecord3(stored) && !("mode" in stored) && Array.isArray(stored.replacements)) {
+            if (isRecord4(stored) && !("mode" in stored) && Array.isArray(stored.replacements)) {
               context.setField("responseBody", { replacements });
             } else {
               context.setField("responseBody", {
@@ -1640,7 +1884,8 @@ var builtInRuleTypes = Object.freeze([
   createRedirectRuleType(),
   queryRuleType,
   createResponseBodyRuleType(),
-  createRequestBodyRuleType()
+  createRequestBodyRuleType(),
+  createMockRuleType()
 ]);
 
 // packages/editor/src/types.ts
@@ -1765,7 +2010,8 @@ var RULE_TYPE_LABELS = {
   query: "Query parameters",
   header: "Header",
   "response-body": "Response body",
-  "request-body": "Request body"
+  "request-body": "Request body",
+  mock: "Mock response"
 };
 var COMMON_RULE_FIELDS = /* @__PURE__ */ new Set([
   "id",
@@ -1790,7 +2036,7 @@ function normalizeProjectActions(value) {
   for (let index = 0; index < value.length; index += 1) {
     if (!Object.hasOwn(value, index)) continue;
     const item = value[index];
-    if (!isRecord4(item)) continue;
+    if (!isRecord5(item)) continue;
     const command = item.command;
     const label = item.label;
     if (typeof command !== "string" || command.length === 0) continue;
@@ -1808,7 +2054,7 @@ function ruleCountLabel(count) {
   if (count === 1) return "1 rule";
   return `${count} rules`;
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function snapshotOwnData(value, ancestors = /* @__PURE__ */ new WeakSet()) {
@@ -1887,11 +2133,11 @@ function freezeSnapshot(value, seen = /* @__PURE__ */ new WeakSet()) {
   return value;
 }
 function asDraftProject(value) {
-  if (!isRecord4(value) || !Array.isArray(value.groups)) return void 0;
+  if (!isRecord5(value) || !Array.isArray(value.groups)) return void 0;
   for (const group of value.groups) {
-    if (!isRecord4(group) || !Array.isArray(group.rules)) return void 0;
+    if (!isRecord5(group) || !Array.isArray(group.rules)) return void 0;
     for (const rule of group.rules) {
-      if (!isRecord4(rule)) return void 0;
+      if (!isRecord5(rule)) return void 0;
     }
   }
   return value;
@@ -1922,7 +2168,7 @@ function valueAtPath(root, path) {
       if (index === void 0 || !Object.hasOwn(current, index))
         return void 0;
       current = current[index];
-    } else if (isRecord4(current) && Object.hasOwn(current, segment)) {
+    } else if (isRecord5(current) && Object.hasOwn(current, segment)) {
       current = current[segment];
     } else {
       return void 0;
@@ -1934,6 +2180,7 @@ var MATCHER_CREATABLE_FIELDS = ["description", "method", "type"];
 var ACTION_PAYLOAD_FIELDS = [
   "redirect",
   "action",
+  "mock",
   "requestBody",
   "responseBody",
   "headerDirection",
@@ -1958,7 +2205,7 @@ function setValueAtPath(root, path, value) {
         return false;
       }
       current = current[childIndex];
-    } else if (isRecord4(current) && Object.hasOwn(current, segment)) {
+    } else if (isRecord5(current) && Object.hasOwn(current, segment)) {
       current = current[segment];
     } else {
       return false;
@@ -1972,7 +2219,7 @@ function setValueAtPath(root, path, value) {
     current[index] = value;
     return true;
   }
-  if (!isRecord4(current)) return false;
+  if (!isRecord5(current)) return false;
   if (!Object.hasOwn(current, finalSegment) && !CREATABLE_RULE_FIELDS.has(finalSegment)) {
     return false;
   }
@@ -1991,7 +2238,7 @@ function deleteValueAtPath(root, path) {
   const parentPath = pointer(...segments.slice(0, -1));
   const parent = valueAtPath(root, parentPath);
   const key = segments[segments.length - 1];
-  if (!isRecord4(parent) || !Object.hasOwn(parent, key)) return false;
+  if (!isRecord5(parent) || !Object.hasOwn(parent, key)) return false;
   return delete parent[key];
 }
 function safeText(value, fallback = "") {
@@ -2027,7 +2274,7 @@ function normalizeDiagnostics(value) {
   }
   const diagnostics = [];
   for (const item of value) {
-    if (!isRecord4(item)) continue;
+    if (!isRecord5(item)) continue;
     const code = item.code;
     const path = item.path;
     const message = item.message;
@@ -2041,7 +2288,7 @@ function isValidExtensionName(name) {
   return name.length > 0 && !COMMON_RULE_FIELDS.has(name) && !FORBIDDEN_EXTENSION_FIELDS.has(name) && !hasControl(name);
 }
 function clearActionFields(rule, keep, keepFields) {
-  if (!isRecord4(rule)) return false;
+  if (!isRecord5(rule)) return false;
   let changed = false;
   for (const field of ACTION_PAYLOAD_FIELDS) {
     if (field === keep || keepFields?.has(field)) continue;
@@ -2057,9 +2304,9 @@ function extensionFieldParent(rule, name) {
   if (segments.length === 0) return void 0;
   let current = rule;
   for (let index = 0; index < segments.length - 1; index += 1) {
-    if (!isRecord4(current)) return void 0;
+    if (!isRecord5(current)) return void 0;
     const next = current[segments[index]];
-    if (!isRecord4(next)) {
+    if (!isRecord5(next)) {
       const created = {};
       Object.defineProperty(current, segments[index], {
         configurable: true,
@@ -2072,7 +2319,7 @@ function extensionFieldParent(rule, name) {
       current = next;
     }
   }
-  if (!isRecord4(current)) return void 0;
+  if (!isRecord5(current)) return void 0;
   return { parent: current, key: segments[segments.length - 1] };
 }
 function toSearchText(value) {
@@ -2129,9 +2376,9 @@ function exactUrlFromSource(source) {
   return decoded;
 }
 function isDryRunResult(value) {
-  if (!isRecord4(value)) return false;
+  if (!isRecord5(value)) return false;
   const summary = value.summary;
-  return Array.isArray(value.results) && Array.isArray(value.errors) && isRecord4(summary) && typeof summary.matchedUrlCount === "number" && typeof summary.urlCount === "number";
+  return Array.isArray(value.results) && Array.isArray(value.errors) && isRecord5(summary) && typeof summary.matchedUrlCount === "number" && typeof summary.urlCount === "number";
 }
 function previewSentence(preview) {
   if (!preview || preview.summary.length === 0) return null;
@@ -2146,6 +2393,8 @@ function previewSentence(preview) {
       return `The request body would be ${preview.summary}.`;
     case "response-body":
       return `The response body would be ${preview.summary}.`;
+    case "mock":
+      return preview.summary;
     default:
       return null;
   }
@@ -2194,7 +2443,7 @@ function applyRuleProposalAction(rule, ruleProposal) {
     }
     case "header": {
       rule.type = "header";
-      if (!isRecord4(action)) return;
+      if (!isRecord5(action)) return;
       const direction = ownString(action, "headerDirection", "direction");
       const operation = ownString(action, "headerOperation", "operation");
       const name = ownString(action, "headerName", "name");
@@ -3504,7 +3753,7 @@ var EditorControllerImpl = class {
         return;
       }
       const diagnostics = normalizeDiagnostics(
-        isRecord4(outcome) ? outcome.diagnostics : void 0
+        isRecord5(outcome) ? outcome.diagnostics : void 0
       );
       this.showDryRunDiagnostics(diagnostics);
     } catch (e) {
@@ -4166,6 +4415,7 @@ var EditorControllerImpl = class {
       "/description",
       description
     );
+    this.options.mountProjectDetails?.(fieldGrid);
     fields.append(fieldGrid);
     this.renderProjectActions(fields);
     this.form.append(fields);
@@ -5565,10 +5815,10 @@ var EditorControllerImpl = class {
   }
 };
 function isSaveSuccess(value) {
-  return isRecord4(value) && value.ok === true;
+  return isRecord5(value) && value.ok === true;
 }
 function saveFailureDiagnostic(value) {
-  if (!isRecord4(value)) {
+  if (!isRecord5(value)) {
     return diagnostic(
       "editor.save-failed",
       "",
@@ -5631,6 +5881,7 @@ export {
   builtInRuleTypes,
   createEditor,
   createHeaderRuleType,
+  createMockRuleType,
   createRedirectRuleType,
   createRequestBodyRuleType,
   createResponseBodyRuleType,