zinkee 0.1.37 → 0.1.38

package/dist/index.js

@@ -461,7 +461,7 @@ var commandRegistry = {
     command: "displays cross-widget-filter set",
     accessLevel: "write",
     supportsExample: true,
-    supportsRaw: false,
+    supportsRaw: true,
     output: writeOutput
   },
   "displays cross-widget-filter delete": {
@@ -4036,40 +4036,86 @@ var specificExamples = {
   ]),
   "displays cross-widget-filter set": buildCommandExamples([
     {
-      description: "Link one source widget/field to several target widgets through the same field.",
+      description: "Single configuration with flags: link one source widget/field to several targets. The whole array is replaced.",
       command: "zinkee --json displays cross-widget-filter set 0f6f062f-1478-4df2-96a1-c495d037d260 --source-widget 11111111-1111-4111-a111-111111111111 --source-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --target 22222222-2222-4222-a222-222222222222:c60b8526-5835-4c9f-aecd-9a16c7704a34 --target 33333333-3333-4333-a333-333333333333:c60b8526-5835-4c9f-aecd-9a16c7704a34",
-      raw: `{
-  "source": {
-    "widgetId": "11111111-1111-4111-a111-111111111111",
-    "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
-  },
-  "targets": [
-    {
-      "widgetId": "22222222-2222-4222-a222-222222222222",
+      raw: `[
+  {
+    "source": {
+      "widgetId": "11111111-1111-4111-a111-111111111111",
       "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
     },
+    "targets": [
+      {
+        "widgetId": "22222222-2222-4222-a222-222222222222",
+        "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+      },
+      {
+        "widgetId": "33333333-3333-4333-a333-333333333333",
+        "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+      }
+    ]
+  }
+]`
+    },
     {
-      "widgetId": "33333333-3333-4333-a333-333333333333",
+      description: "Several independent configurations with --raw (each source filters its own targets). A widget cannot be a target of two configurations.",
+      command: `zinkee --json displays cross-widget-filter set 0f6f062f-1478-4df2-96a1-c495d037d260 --raw '[{"source":{"widgetId":"11111111-1111-4111-a111-111111111111","fieldId":"c60b8526-5835-4c9f-aecd-9a16c7704a34"},"targets":[{"widgetId":"22222222-2222-4222-a222-222222222222","fieldId":"c60b8526-5835-4c9f-aecd-9a16c7704a34"}]},{"source":{"widgetId":"44444444-4444-4444-a444-444444444444","fieldId":"a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"},"targets":[{"widgetId":"55555555-5555-4555-a555-555555555555","fieldId":"a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"}]}]'`,
+      raw: `[
+  {
+    "source": {
+      "widgetId": "11111111-1111-4111-a111-111111111111",
       "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
-    }
-  ]
-}`
     },
-    {
-      description: "Filter one target widget by the status field of the source.",
-      command: "zinkee --json displays cross-widget-filter set 0f6f062f-1478-4df2-96a1-c495d037d260 --source-widget 11111111-1111-4111-a111-111111111111 --source-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --target 66666666-6666-4666-a666-666666666666:a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
-      raw: `{
-  "source": {
-    "widgetId": "11111111-1111-4111-a111-111111111111",
-    "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"
+    "targets": [
+      {
+        "widgetId": "22222222-2222-4222-a222-222222222222",
+        "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+      }
+    ]
   },
-  "targets": [
+  {
+    "source": {
+      "widgetId": "44444444-4444-4444-a444-444444444444",
+      "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"
+    },
+    "targets": [
+      {
+        "widgetId": "55555555-5555-4555-a555-555555555555",
+        "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"
+      }
+    ]
+  }
+]`
+    },
     {
-      "widgetId": "66666666-6666-4666-a666-666666666666",
+      description: "Hierarchy chain with --raw-file: a target of one configuration is the source of the next (click Parent \u2192 filters Child, click Child \u2192 filters Grandchild).",
+      command: "zinkee --json displays cross-widget-filter set 0f6f062f-1478-4df2-96a1-c495d037d260 --raw-file cross-widget-filter.json",
+      raw: `[
+  {
+    "source": {
+      "widgetId": "11111111-1111-4111-a111-111111111111",
+      "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+    },
+    "targets": [
+      {
+        "widgetId": "22222222-2222-4222-a222-222222222222",
+        "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+      }
+    ]
+  },
+  {
+    "source": {
+      "widgetId": "22222222-2222-4222-a222-222222222222",
       "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"
-    }
-  ]
-}`
+    },
+    "targets": [
+      {
+        "widgetId": "33333333-3333-4333-a333-333333333333",
+        "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"
+      }
+    ]
+  }
+]`
     }
   ]),
   "schemas list": buildCommandExamples([
@@ -4962,18 +5008,20 @@ var specificExamples = {
       }
     }
   ],
-  "crossWidgetFilter": {
-    "source": {
-      "widgetId": "11111111-1111-4111-a111-111111111111",
-      "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
-    },
-    "targets": [
-      {
-        "widgetId": "22222222-2222-4222-a222-222222222222",
+  "crossWidgetFilter": [
+    {
+      "sourceWidget": {
+        "widgetId": "11111111-1111-4111-a111-111111111111",
         "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
-      }
-    ]
-  },
+      },
+      "targetWidgets": [
+        {
+          "widgetId": "22222222-2222-4222-a222-222222222222",
+          "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+        }
+      ]
+    }
+  ],
   "navigationTargets": [
     {
       "id": "nav-target-customer",
@@ -9226,20 +9274,54 @@ function buildNavigationTargetBody(options) {
   }
   return body;
 }
+function readRawArray(raw, rawFile) {
+  if (raw && rawFile) {
+    throw new CliError("invalid_cli_usage", 'Use either "--raw" or "--raw-file", not both.');
+  }
+  const source = rawFile ? readFileSync4(rawFile, "utf8") : raw;
+  if (!source) {
+    return [];
+  }
+  try {
+    const parsed = JSON.parse(source);
+    if (!Array.isArray(parsed)) {
+      throw new CliError("invalid_cli_usage", "Raw cross widget filter payload must be a JSON array of configurations.");
+    }
+    return parsed;
+  } catch (error) {
+    if (error instanceof CliError) throw error;
+    throw new CliError("invalid_cli_usage", "Raw JSON payload is invalid.");
+  }
+}
 function buildCrossWidgetFilterBody(options) {
-  return {
-    source: {
-      widgetId: options.sourceWidget,
-      fieldId: options.sourceField
-    },
-    targets: options.target.map((entry) => {
-      const [widgetId, fieldId] = entry.split(":");
-      if (!widgetId || !fieldId) {
-        throw new CliError("invalid_cli_usage", `Invalid --target entry "${entry}". Use <widgetId:fieldId>.`);
-      }
-      return { widgetId, fieldId };
-    })
+  if (options.raw !== void 0 || options.rawFile !== void 0) {
+    return readRawArray(options.raw, options.rawFile);
+  }
+  if (!options.sourceWidget || !options.sourceField) {
+    throw new CliError(
+      "invalid_cli_usage",
+      "Provide --source-widget and --source-field, or --raw/--raw-file with the full configuration array."
+    );
+  }
+  const source = {
+    widgetId: options.sourceWidget,
+    fieldId: options.sourceField
   };
+  if (options.sourceSchema) {
+    source.schemaId = options.sourceSchema;
+  }
+  return [
+    {
+      source,
+      targets: (options.target ?? []).map((entry) => {
+        const [widgetId, fieldId] = entry.split(":");
+        if (!widgetId || !fieldId) {
+          throw new CliError("invalid_cli_usage", `Invalid --target entry "${entry}". Use <widgetId:fieldId>.`);
+        }
+        return { widgetId, fieldId };
+      })
+    }
+  ];
 }
 function registerDisplaysCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
@@ -9586,9 +9668,9 @@ function registerDisplaysCommands(program, options = {}) {
       emitJson4(stdout, "displays cross-widget-filter get", item);
       return;
     }
-    printTable(item ? [item] : [], void 0, stdout);
+    printTable(item ?? [], void 0, stdout);
   });
-  cross.command("set").description("Set cross widget filter").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--source-widget <id>").requiredOption("--source-field <id>").requiredOption("--target <widget:field>", "repeatable target", (v, p = []) => [...p, v], []).action(async function action(display, commandOptions) {
+  cross.command("set").description("Set cross widget filter (replaces the whole array of configurations)").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--source-widget <id>", "source widget id (single-configuration mode)").option("--source-field <id>", "source field id (single-configuration mode)").option("--source-schema <id>", "source schema id, only for HIERARCHY source widgets").option("--target <widget:field>", "repeatable target (single-configuration mode)", (v, p = []) => [...p, v], []).option("--raw <json>", "full array of configurations as JSON (for several configurations)").option("--raw-file <path>", "path to a JSON file with the full array of configurations").action(async function action(display, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays cross-widget-filter set", readOnly, "write");
     const data = await api.setCrossWidgetFilter(display, buildCrossWidgetFilterBody(commandOptions));