zinkee 0.1.18 → 0.1.20

package/.claude/settings.local.json

@@ -0,0 +1,47 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm test *)",
+      "Bash(npm run *)",
+      "Bash(pnpm typecheck *)",
+      "Bash(pnpm test *)",
+      "Bash(npx tsc *)",
+      "Read(//home/guillermo/dev/z2-backend/api/src/main/java/com/zinkee/api/domain/model/v2/log/**)",
+      "Read(//home/guillermo/dev/z2-backend/**)",
+      "Bash(grep *)",
+      "Bash(npx vitest *)",
+      "Bash(npx tsx *)",
+      "Bash(node dist/index.js --help)",
+      "Bash(gh repo *)",
+      "WebFetch(domain:github.com)",
+      "Bash(git config *)",
+      "Read(//home/guillermo/.config/**)",
+      "Read(//home/guillermo/**)",
+      "Bash(curl *)",
+      "Bash(node dist/index.js --show-completion zsh)",
+      "Bash(node *)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee\" COMP_CWORD=1 node *)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas\" COMP_CWORD=2 node *)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas fields\" COMP_CWORD=3 node dist/index.js)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas fields cr\" COMP_CWORD=3 node dist/index.js)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas list --j\" COMP_CWORD=3 node dist/index.js)",
+      "Bash(rm -rf /tmp/zinkee-install)",
+      "Bash(mkdir -p /tmp/zinkee-install)",
+      "Bash(HOME=/tmp/zinkee-install SHELL=/bin/zsh node dist/index.js --install-completion)",
+      "Read(//tmp/**)",
+      "Read(//tmp/zinkee-install/**)",
+      "Bash(rm -rf /tmp/zinkee-install-bash)",
+      "Bash(mkdir -p /tmp/zinkee-install-bash)",
+      "Bash(HOME=/tmp/zinkee-install-bash SHELL=/bin/bash node dist/index.js --install-completion)",
+      "Bash(rm -rf /tmp/zinkee-install-fish)",
+      "Bash(mkdir -p /tmp/zinkee-install-fish)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete node dist/index.js)",
+      "Bash(echo \"exit: $?\")",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas\" COMP_CWORD=abc node dist/index.js)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee config show --foo --bar baz quux ?\" COMP_CWORD=10 node dist/index.js)",
+      "Bash(git -C /home/guillermo/dev/cli status)",
+      "Bash(git -C /home/guillermo/dev/cli branch --show-current)",
+      "Bash(git -C /home/guillermo/dev/cli diff --stat)"
+    ]
+  }
+}

package/README.md

@@ -480,17 +480,25 @@ zinkee displays layout update <display-uuid> --template freeform --freeform-layo
 }'
 ```
 
-### KPI with filters
+### Widget filters
 
-The `--filter` flag doesn't work on KPI widgets. Pass filters in `--raw`:
+Pass `--filter "<field>:<comparator>:<value>"` (repeatable) and the CLI turns it into the structured `query.filters[]` payload the API expects. Field accepts UUID or slug. Supported comparators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `contains`, `in` (comma-separated values), `is_empty`, `is_not_empty`.
 
 ```bash
---raw '{"query":{"filters":[{"fieldId":"<field-uuid>","operator":"EQUALS","value":"2"}]}}'
+zinkee --json displays widgets update <display-uuid> <widget-uuid> \
+  --filter "status:eq:2" \
+  --filter "amount:gte:500"
+```
+
+For comparators the parser does not cover yet (e.g. `NOT_CONTAINS`, `RANGE`) keep using `--raw`:
+
+```bash
+--raw '{"query":{"filters":[{"origin":{"fieldId":"<field>"},"comparisonOperator":"RANGE","values":["2025-01-01","2025-12-31"]}]}}'
 ```
 
 ### Slug support
 
-Slugs are resolved to UUIDs in: `--field`, `--source-schema`, `--source-field`, `--x-axis-field`, `kpi.fieldCalc`, `chart.xAxisFieldId`, `chart.yAxisSeries[].fieldCalc`, `bindings.variableMap` values.
+Slugs are resolved to UUIDs in: `--field`, `--source-schema`, `--source-field`, `--x-axis-field`, `--filter` field reference, `kpi.fieldCalc`, `chart.xAxisFieldId`, `chart.yAxisSeries[].fieldCalc`, `bindings.variableMap` values.
 
 Display UUIDs are required for `displays widgets create/update` and `displays variables create`.
 

package/dist/index.js

@@ -987,6 +987,21 @@ function parseErrorBody(text, contentType) {
     return text;
   }
 }
+function summarizeNetworkCause(cause) {
+  const seen = /* @__PURE__ */ new Set();
+  let current = cause;
+  while (current && typeof current === "object" && !seen.has(current)) {
+    seen.add(current);
+    const candidate = current;
+    const message = typeof candidate.message === "string" ? candidate.message.trim() : "";
+    const code = typeof candidate.code === "string" ? candidate.code : void 0;
+    if (message && message !== "fetch failed") {
+      return code && !message.includes(code) ? `${message} (${code})` : message;
+    }
+    current = candidate.cause;
+  }
+  return void 0;
+}
 var ApiClient = class {
   constructor(options) {
     this.options = options;
@@ -1061,7 +1076,9 @@ var ApiClient = class {
           cause
         });
       }
-      throw new ApiClientError("network_error", `Request failed for ${method} ${url}.`, {
+      const causeSummary = summarizeNetworkCause(cause);
+      const message = causeSummary ? `Request failed for ${method} ${url}: ${causeSummary}.` : `Request failed for ${method} ${url}.`;
+      throw new ApiClientError("network_error", message, {
         url,
         method,
         cause
@@ -1139,7 +1156,11 @@ var cliExitCodeByErrorCode = {
   unknown_error: 1,
   invalid_cli_usage: 2,
   configuration_error: 2,
-  command_not_allowed_in_read_only_mode: 7
+  command_not_allowed_in_read_only_mode: 7,
+  network_error: 1,
+  http_error: 1,
+  timeout: 1,
+  invalid_json: 1
 };
 var errorCodeByName = {
   ProfileResolutionError: "configuration_error"
@@ -1216,7 +1237,7 @@ function toCliError(error) {
   }
   if (error instanceof ApiClientError) {
     const apiError = extractApiErrorDetails(error);
-    return new CliError("unknown_error", apiError.message, apiError.details);
+    return new CliError(error.code, apiError.message, apiError.details);
   }
   if (error instanceof Error) {
     return new CliError(errorCodeByName[error.name] ?? "unknown_error", error.message);
@@ -3492,29 +3513,38 @@ var specificExamples = {
 }`
     },
     {
-      description: "Add query filters that match the full comparisonOperator contract (requires --raw because --filter only accepts free-form expressions).",
-      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --raw '{"query":{"filters":[{"origin":{"schemaId":"contacts","fieldId":"status"},"comparisonOperator":"EQUAL","values":["2"]},{"origin":{"schemaId":"contacts","fieldId":"amount"},"comparisonOperator":"GREATER_OR_EQUAL","values":["500"]}]}}'`,
+      description: "Add query filters with --filter. The CLI parses the expression and emits the structured comparisonOperator payload the API expects.",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --filter "status:eq:2" --filter "amount:gte:500"`,
       raw: `{
   "query": {
     "filters": [
       {
-        "origin": {
-          "schemaId": "contacts",
-          "fieldId": "status"
-        },
+        "origin": { "fieldId": "status" },
         "comparisonOperator": "EQUAL",
         "values": ["2"]
       },
       {
-        "origin": {
-          "schemaId": "contacts",
-          "fieldId": "amount"
-        },
+        "origin": { "fieldId": "amount" },
         "comparisonOperator": "GREATER_OR_EQUAL",
         "values": ["500"]
       }
     ]
   }
+}`
+    },
+    {
+      description: "Fall back to --raw for comparators the parser does not cover yet (e.g. NOT_CONTAINS, RANGE).",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --raw '{"query":{"filters":[{"origin":{"fieldId":"due-date"},"comparisonOperator":"RANGE","values":["2025-01-01","2025-12-31"]}]}}'`,
+      raw: `{
+  "query": {
+    "filters": [
+      {
+        "origin": { "fieldId": "due-date" },
+        "comparisonOperator": "RANGE",
+        "values": ["2025-01-01", "2025-12-31"]
+      }
+    ]
+  }
 }`
     },
     {
@@ -5854,19 +5884,15 @@ function resolveProfile(config, overrides = {}) {
   }
   throw new ProfileResolutionError("No profile could be resolved from config.");
 }
-function validateBaseUrl(value) {
+function validateBaseUrl(value, source = "Base URL") {
   let parsed;
   try {
     parsed = new URL(value);
   } catch {
-    throw new ProfileResolutionError(
-      `Environment variable ${ENV_BASE_URL} must be an absolute http(s) URL.`
-    );
+    throw new ProfileResolutionError(`${source} must be an absolute http(s) URL.`);
   }
   if (!["http:", "https:"].includes(parsed.protocol) || !parsed.host) {
-    throw new ProfileResolutionError(
-      `Environment variable ${ENV_BASE_URL} must be an absolute http(s) URL.`
-    );
+    throw new ProfileResolutionError(`${source} must be an absolute http(s) URL.`);
   }
   return value.replace(/\/+$/, "");
 }
@@ -5878,7 +5904,7 @@ function readEnvBaseUrl(env = process.env) {
   if (!baseUrl) {
     return void 0;
   }
-  return validateBaseUrl(baseUrl);
+  return validateBaseUrl(baseUrl, `Environment variable ${ENV_BASE_URL}`);
 }
 function readEnvProfile(env = process.env) {
   return toNonEmptyString(env[ENV_PROFILE]);
@@ -6233,9 +6259,10 @@ function resolveRuntimeContext(config, overrides = {}) {
   const envProfile = readEnvProfile();
   const envApiKey = readEnvApiKey();
   const envBaseUrl = readEnvBaseUrl();
+  const flagBaseUrl = overrides.baseUrl !== void 0 ? validateBaseUrl(overrides.baseUrl, '"--base-url"') : void 0;
   const profileOverride = overrides.profile ?? envProfile;
   const apiKeyOverride = overrides.apiKey ?? envApiKey;
-  const baseUrlOverride = overrides.baseUrl ?? envBaseUrl;
+  const baseUrlOverride = flagBaseUrl ?? envBaseUrl;
   if (apiKeyOverride && !baseUrlOverride) {
     throw new ProfileResolutionError(
       `Runtime API key was provided, but ${ENV_BASE_URL} or --base-url is missing.`
@@ -7868,6 +7895,86 @@ var DisplaysApi = class {
   }
 };
 
+// src/parsers/expressions.ts
+var supportedComparators = /* @__PURE__ */ new Set([
+  "eq",
+  "neq",
+  "gt",
+  "gte",
+  "lt",
+  "lte",
+  "contains",
+  "in",
+  "is_empty",
+  "is_not_empty"
+]);
+var noValueComparators = /* @__PURE__ */ new Set(["is_empty", "is_not_empty"]);
+function parseColonExpression(input) {
+  const parts = input.split(":");
+  if (parts.length < 2) {
+    throw new Error(`Expected a field:comparator[:value] expression, got "${input}".`);
+  }
+  const field = parts[0]?.trim();
+  const comparator = parts[1]?.trim();
+  if (!field) {
+    throw new Error(`Expected a field before ":", got "${input}".`);
+  }
+  if (!comparator) {
+    throw new Error(`Expected a comparator after "${field}:", got "${input}".`);
+  }
+  return [field, comparator, parts.slice(2).join(":").trim()];
+}
+function parseSpaceExpression(input) {
+  const parts = input.trim().split(/\s+/);
+  if (parts.length < 2) {
+    throw new Error(`Expected a field comparator expression, got "${input}".`);
+  }
+  const field = parts[0];
+  const comparator = parts[1];
+  if (!field) {
+    throw new Error(`Expected a field comparator expression, got "${input}".`);
+  }
+  if (!comparator) {
+    throw new Error(`Expected a comparator after "${field}", got "${input}".`);
+  }
+  return [field.trim(), comparator.trim(), parts.slice(2).join(" ").trim()];
+}
+function normalizeValue(comparator, rawValue) {
+  if (noValueComparators.has(comparator)) {
+    if (rawValue.length > 0) {
+      throw new Error(`Comparator "${comparator}" does not accept a value.`);
+    }
+    return null;
+  }
+  if (comparator === "in") {
+    const values = rawValue.split(",").map((value) => value.trim()).filter(Boolean);
+    if (values.length === 0) {
+      throw new Error(`Comparator "${comparator}" requires at least one value.`);
+    }
+    return values;
+  }
+  if (rawValue.length === 0) {
+    throw new Error(`Comparator "${comparator}" requires a value.`);
+  }
+  return rawValue;
+}
+function parseExpression(input) {
+  const trimmed = input.trim();
+  const [field, comparatorCandidate, rawValue] = trimmed.includes(":") && !trimmed.includes(" ") ? parseColonExpression(trimmed) : parseSpaceExpression(trimmed);
+  if (!supportedComparators.has(comparatorCandidate)) {
+    throw new Error(
+      `Unsupported comparator "${comparatorCandidate}" in expression "${input}".`
+    );
+  }
+  const comparator = comparatorCandidate;
+  return {
+    field,
+    comparator,
+    value: normalizeValue(comparator, rawValue),
+    raw: trimmed
+  };
+}
+
 // src/commands/displays.ts
 function getCommandIo4(stdout) {
   return stdout ?? process.stdout;
@@ -7932,6 +8039,37 @@ function parseUuidOrSlugSelector3(input) {
     throw new InvalidArgumentError3(message);
   }
 }
+var COMPARATOR_TO_DISPLAY_OPERATOR = {
+  eq: "EQUAL",
+  neq: "NOT_EQUAL",
+  gt: "GREATER",
+  gte: "GREATER_OR_EQUAL",
+  lt: "LESS",
+  lte: "LESS_OR_EQUAL",
+  contains: "CONTAINS",
+  in: "ANY_OF",
+  is_empty: "IS_EMPTY",
+  is_not_empty: "IS_NOT_EMPTY"
+};
+function toDisplayFilter(parsed) {
+  const values = parsed.value === null ? [] : Array.isArray(parsed.value) ? [...parsed.value] : [parsed.value];
+  return {
+    origin: { fieldId: parsed.field },
+    comparisonOperator: COMPARATOR_TO_DISPLAY_OPERATOR[parsed.comparator],
+    values
+  };
+}
+function parseFilterExpression(input) {
+  try {
+    return parseExpression(input);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid filter expression.";
+    throw new InvalidArgumentError3(message);
+  }
+}
+function collectFilters(value, previous = []) {
+  return [...previous, parseFilterExpression(value)];
+}
 function readRawObject2(raw, rawFile) {
   if (raw && rawFile) {
     throw new CliError("invalid_cli_usage", 'Use either "--raw" or "--raw-file", not both.');
@@ -7998,7 +8136,7 @@ function buildVariableBody(options) {
     };
   }
   if (options.filter && options.filter.length > 0) {
-    body.filters = options.filter.map((entry) => ({ raw: entry }));
+    body.filters = options.filter.map(toDisplayFilter);
   }
   if (options.dateMode || options.dateDynamicOption || options.dateSpecific || options.dateRangeStart || options.dateRangeEnd) {
     body.date = {
@@ -8047,15 +8185,19 @@ function buildWidgetBody(options) {
       layout
     };
   }
-  if (options.field?.length || options.sort?.length || options.filter?.length) {
+  if (options.field && options.field.length > 0) {
     body.view = {
       ...typeof body.view === "object" && body.view ? body.view : {},
       fields: options.field
     };
+  }
+  const queryMerge = {};
+  if (options.sort && options.sort.length > 0) queryMerge.sorts = options.sort;
+  if (options.filter && options.filter.length > 0) queryMerge.filters = options.filter.map(toDisplayFilter);
+  if (Object.keys(queryMerge).length > 0) {
     body.query = {
       ...typeof body.query === "object" && body.query ? body.query : {},
-      sorts: options.sort,
-      filters: options.filter?.map((entry) => ({ raw: entry }))
+      ...queryMerge
     };
   }
   if (options.widgetReadOnly !== void 0 || options.hideAddButton !== void 0 || options.hideDeleteButton !== void 0 || options.hideSortButton !== void 0 || options.hideFilterButton !== void 0 || options.hideSeeButton !== void 0) {
@@ -8270,7 +8412,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     printTable([match], void 0, stdout);
   });
-  variables.command("create").description("Create variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
+  variables.command("create").description("Create variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays variables create", readOnly, "write");
     const data = await api.createVariable(display, buildVariableBody(commandOptions));
@@ -8280,7 +8422,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     writeLine4(stdout, `Created variable on display "${display.value}".`);
   });
-  variables.command("update").description("Update variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<variable>", "variable id").option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, variableId, commandOptions) {
+  variables.command("update").description("Update variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<variable>", "variable id").option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, variableId, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays variables update", readOnly, "write");
     const data = await api.updateVariable(display, variableId, buildVariableBody(commandOptions));
@@ -8320,7 +8462,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     printTable([data], void 0, stdout);
   });
-  widgets.command("create").description("Create widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--type <type>", "widget type").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
+  widgets.command("create").description("Create widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--type <type>", "widget type").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", collectFilters, []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays widgets create", readOnly, "write");
     const data = await api.createWidget(display, buildWidgetBody(commandOptions));
@@ -8330,7 +8472,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     writeLine4(stdout, `Created widget on display "${display.value}".`);
   });
-  widgets.command("update").description("Update widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<widget>", "widget id").option("--type <type>").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, widgetId, commandOptions) {
+  widgets.command("update").description("Update widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<widget>", "widget id").option("--type <type>").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", collectFilters, []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, widgetId, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays widgets update", readOnly, "write");
     const data = await api.updateWidget(display, widgetId, buildWidgetBody(commandOptions));
@@ -9049,6 +9191,19 @@ function toDisplayProfile(profileName, profile, defaultProfile) {
 function loadConfigForAdd(filePath) {
   return readConfigIfExists(filePath) ?? { profiles: {} };
 }
+function normalizeProfileBaseUrl(baseUrl) {
+  if (baseUrl === void 0) {
+    return void 0;
+  }
+  try {
+    return validateBaseUrl(baseUrl, '"--base-url"');
+  } catch (error) {
+    if (error instanceof ProfileResolutionError) {
+      throw new CliError("configuration_error", error.message);
+    }
+    throw error;
+  }
+}
 function emitProfilesTable(stdout, data) {
   printTable(
     data.map((profile) => ({
@@ -9109,9 +9264,10 @@ function registerProfilesCommands(program, options = {}) {
         `Profile "${profileName}" already exists in config.`
       );
     }
+    const baseUrl = normalizeProfileBaseUrl(commandOptions.baseUrl);
     let nextConfig = setProfileConfig(config, profileName, {
       apiKey: commandOptions.apiKey,
-      baseUrl: commandOptions.baseUrl
+      baseUrl
     });
     if (!nextConfig.defaultProfile) {
       nextConfig = setDefaultProfile(nextConfig, profileName);
@@ -9137,9 +9293,10 @@ function registerProfilesCommands(program, options = {}) {
     }
     const config = readRequiredConfig(filePath);
     getRequiredProfile(config, profileName);
+    const baseUrl = normalizeProfileBaseUrl(commandOptions.baseUrl);
     const nextConfig = setProfileConfig(config, profileName, {
       apiKey: commandOptions.apiKey,
-      baseUrl: commandOptions.baseUrl
+      baseUrl
     });
     writeConfig(nextConfig, filePath);
     const data = toDisplayProfile(
@@ -9336,86 +9493,6 @@ var SchemasApi = class {
   }
 };
 
-// src/parsers/expressions.ts
-var supportedComparators = /* @__PURE__ */ new Set([
-  "eq",
-  "neq",
-  "gt",
-  "gte",
-  "lt",
-  "lte",
-  "contains",
-  "in",
-  "is_empty",
-  "is_not_empty"
-]);
-var noValueComparators = /* @__PURE__ */ new Set(["is_empty", "is_not_empty"]);
-function parseColonExpression(input) {
-  const parts = input.split(":");
-  if (parts.length < 2) {
-    throw new Error(`Expected a field:comparator[:value] expression, got "${input}".`);
-  }
-  const field = parts[0]?.trim();
-  const comparator = parts[1]?.trim();
-  if (!field) {
-    throw new Error(`Expected a field before ":", got "${input}".`);
-  }
-  if (!comparator) {
-    throw new Error(`Expected a comparator after "${field}:", got "${input}".`);
-  }
-  return [field, comparator, parts.slice(2).join(":").trim()];
-}
-function parseSpaceExpression(input) {
-  const parts = input.trim().split(/\s+/);
-  if (parts.length < 2) {
-    throw new Error(`Expected a field comparator expression, got "${input}".`);
-  }
-  const field = parts[0];
-  const comparator = parts[1];
-  if (!field) {
-    throw new Error(`Expected a field comparator expression, got "${input}".`);
-  }
-  if (!comparator) {
-    throw new Error(`Expected a comparator after "${field}", got "${input}".`);
-  }
-  return [field.trim(), comparator.trim(), parts.slice(2).join(" ").trim()];
-}
-function normalizeValue(comparator, rawValue) {
-  if (noValueComparators.has(comparator)) {
-    if (rawValue.length > 0) {
-      throw new Error(`Comparator "${comparator}" does not accept a value.`);
-    }
-    return null;
-  }
-  if (comparator === "in") {
-    const values = rawValue.split(",").map((value) => value.trim()).filter(Boolean);
-    if (values.length === 0) {
-      throw new Error(`Comparator "${comparator}" requires at least one value.`);
-    }
-    return values;
-  }
-  if (rawValue.length === 0) {
-    throw new Error(`Comparator "${comparator}" requires a value.`);
-  }
-  return rawValue;
-}
-function parseExpression(input) {
-  const trimmed = input.trim();
-  const [field, comparatorCandidate, rawValue] = trimmed.includes(":") && !trimmed.includes(" ") ? parseColonExpression(trimmed) : parseSpaceExpression(trimmed);
-  if (!supportedComparators.has(comparatorCandidate)) {
-    throw new Error(
-      `Unsupported comparator "${comparatorCandidate}" in expression "${input}".`
-    );
-  }
-  const comparator = comparatorCandidate;
-  return {
-    field,
-    comparator,
-    value: normalizeValue(comparator, rawValue),
-    raw: trimmed
-  };
-}
-
 // src/commands/records.ts
 function getCommandIo9(stdout) {
   return stdout ?? process.stdout;