zinkee 0.1.39 → 0.1.41

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,77 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    name: Publish package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+          package-manager-cache: false
+
+      - name: Check package version
+        id: version
+        shell: bash
+        run: |
+          package_name="$(node -p "require('./package.json').name")"
+          package_version="$(node -p "require('./package.json').version")"
+
+          set +e
+          lookup_output="$(npm view "${package_name}@${package_version}" version 2>&1)"
+          lookup_status=$?
+          set -e
+
+          if [ "$lookup_status" -eq 0 ]; then
+            echo "${package_name}@${package_version} is already published; skipping."
+            echo "already-published=true" >> "$GITHUB_OUTPUT"
+          elif echo "$lookup_output" | grep -q "E404"; then
+            echo "${package_name}@${package_version} is not published yet."
+            echo "already-published=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "$lookup_output" >&2
+            exit "$lookup_status"
+          fi
+
+      - name: Set up trusted publishing
+        if: steps.version.outputs.already-published == 'false'
+        run: npm install --global npm@11.5.1
+
+      - name: Install dependencies
+        if: steps.version.outputs.already-published == 'false'
+        run: npm ci
+
+      - name: Run tests
+        if: steps.version.outputs.already-published == 'false'
+        run: npm test
+
+      - name: Run typecheck
+        if: steps.version.outputs.already-published == 'false'
+        run: npm run typecheck
+
+      - name: Build project
+        if: steps.version.outputs.already-published == 'false'
+        run: npm run build
+
+      - name: Inspect package contents
+        if: steps.version.outputs.already-published == 'false'
+        run: npm pack --dry-run
+
+      - name: Publish package
+        if: steps.version.outputs.already-published == 'false'
+        run: npm publish --access public

package/.github/workflows/pr-checks.yml

@@ -0,0 +1,36 @@
+name: PR Checks
+
+on:
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    name: Test, Typecheck, and Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Run typecheck
+        run: npm run typecheck
+
+      - name: Build project
+        run: npm run build

package/AGENTS.md

@@ -101,8 +101,9 @@ Prefer focused command tests and parser/client unit tests.
 
 - Versioning is patch-only today (`0.1.x`). Bump the patch number unless the
   team decides to move to a different scheme.
-- Every PR that ships user-visible changes (new commands, fixed examples,
-  behaviour changes) bumps `package.json` version in the same PR — not in a
-  separate "release" PR.
+- If an agent determines that a PR requires a new published version, it must
+  bump the version in `package.json` in that same PR and keep
+  `package-lock.json` in sync. User-visible changes (new commands, fixed
+  examples, behaviour changes) always require this.
 - Before bumping, fetch `origin/main` to make sure the version you pick isn't
   already taken by another PR that merged ahead of yours.

package/dist/index.js

@@ -1224,6 +1224,17 @@ function buildJsonSuccess(data, meta = {}) {
 function buildJsonError(error, meta = {}) {
   return { error, meta };
 }
+var FOLDER_TABLE_KEYS = ["folderId", "folderName", "folderIsRoot"];
+function folderColumns(folder) {
+  if (!folder) {
+    return { folderId: "", folderName: "", folderIsRoot: "" };
+  }
+  return {
+    folderId: folder.id ?? "",
+    folderName: folder.name ?? (folder.isRoot === true ? "(root)" : ""),
+    folderIsRoot: folder.isRoot === void 0 ? "" : String(folder.isRoot)
+  };
+}
 function getWriter(writer) {
   return writer ?? process.stdout;
 }
@@ -4963,21 +4974,36 @@ var specificExamples = {
     "name": "Executive Revenue",
     "layoutTemplate": "widget_row_tabs",
     "variableCount": 3,
-    "widgetCount": 6
+    "widgetCount": 6,
+    "folder": {
+      "id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+      "name": "\u{1F4CA} Executive",
+      "isRoot": false
+    }
   },
   {
     "id": "6b7c8d9e-0f12-3456-789a-bcdef0123456",
     "name": "Sales Pipeline",
     "layoutTemplate": "freeform",
     "variableCount": 1,
-    "widgetCount": 3
+    "widgetCount": 3,
+    "folder": {
+      "id": "a0b1c2d3-e4f5-4061-8273-8495a6b7c8d9",
+      "name": null,
+      "isRoot": true
+    }
   },
   {
     "id": "ef012345-6789-4abc-8def-0123456789ab",
     "name": "Customer Detail",
     "layoutTemplate": "grid",
     "variableCount": 0,
-    "widgetCount": 2
+    "widgetCount": 2,
+    "folder": {
+      "id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+      "name": "\u{1F4CA} Executive",
+      "isRoot": false
+    }
   }
 ]`
     }
@@ -5109,7 +5135,12 @@ var specificExamples = {
       "targetVariableId": "aaaaaaaa-1111-4111-a111-111111111111",
       "label": "Open customer"
     }
-  ]
+  ],
+  "folder": {
+    "id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+    "name": "\u{1F4CA} Executive",
+    "isRoot": false
+  }
 }`
     }
   ]),
@@ -7361,23 +7392,45 @@ function readJsonValueOption(raw, rawFile, rawLabel, rawFileLabel) {
 function readJsonObjectOption(raw, rawFile, rawLabel, rawFileLabel) {
   return readJsonValueOption(raw, rawFile, rawLabel, rawFileLabel) ?? {};
 }
+var NO_VALUE_COMPARATORS = /* @__PURE__ */ new Set([
+  "chg",
+  "changes",
+  "ie",
+  "is_empty",
+  "ine",
+  "is_not_empty"
+]);
+function isNoValueComparator(comparator) {
+  return NO_VALUE_COMPARATORS.has(comparator.toLowerCase());
+}
+function conditionFormatError(input) {
+  return new CliError(
+    "invalid_cli_usage",
+    `Expected condition in the form field:comparator:value, or field:comparator for comparators without value (chg, ie, ine), received "${input}".`
+  );
+}
 function parseCondition(input) {
   const firstSeparator = input.indexOf(":");
   const secondSeparator = input.indexOf(":", firstSeparator + 1);
-  if (firstSeparator <= 0 || secondSeparator <= firstSeparator + 1) {
-    throw new CliError(
-      "invalid_cli_usage",
-      `Expected condition in the form field:comparator:value, received "${input}".`
-    );
+  if (firstSeparator <= 0) {
+    throw conditionFormatError(input);
+  }
+  if (secondSeparator === -1) {
+    const field2 = input.slice(0, firstSeparator).trim();
+    const comparator2 = input.slice(firstSeparator + 1).trim();
+    if (!field2 || !comparator2 || !isNoValueComparator(comparator2)) {
+      throw conditionFormatError(input);
+    }
+    return { field: field2, comparator: comparator2, values: [] };
+  }
+  if (secondSeparator <= firstSeparator + 1) {
+    throw conditionFormatError(input);
   }
   const field = input.slice(0, firstSeparator).trim();
   const comparator = input.slice(firstSeparator + 1, secondSeparator).trim();
   const value = input.slice(secondSeparator + 1).trim();
   if (!field || !comparator || !value) {
-    throw new CliError(
-      "invalid_cli_usage",
-      `Expected condition in the form field:comparator:value, received "${input}".`
-    );
+    throw conditionFormatError(input);
   }
   return {
     field,
@@ -7524,10 +7577,11 @@ function normalizeAutomationConditions(conditions, label, options) {
     const field = typeof condition.field === "string" ? condition.field.trim() : "";
     const comparator = typeof condition.comparator === "string" ? condition.comparator.trim() : "";
     const values = condition.values;
-    if (!field || !comparator || !Array.isArray(values) || values.length === 0) {
+    const allowsEmptyValues = isNoValueComparator(comparator);
+    if (!field || !comparator || !Array.isArray(values) || values.length === 0 && !allowsEmptyValues) {
       throw new CliError(
         "invalid_cli_usage",
-        `Expected ${label} ${index + 1} to contain "field", "comparator", and a non-empty "values" array.`
+        `Expected ${label} ${index + 1} to contain "field", "comparator", and a non-empty "values" array (comparators without value, e.g. chg/ie/ine, accept an empty array).`
       );
     }
     return {
@@ -7612,9 +7666,9 @@ function automationRows(automations) {
     id: automation.id ?? "",
     name: automation.name ?? "",
     status: automation.status ?? "",
-    folderId: automation.folderId ?? "",
     triggerType: isJsonObject2(automation.trigger) && typeof automation.trigger.type === "string" ? automation.trigger.type : "",
-    actionCount: Array.isArray(automation.actions) ? automation.actions.length : ""
+    actionCount: Array.isArray(automation.actions) ? automation.actions.length : "",
+    ...folderColumns(automation.folder)
   }));
 }
 function actionRows(actions) {
@@ -8004,7 +8058,7 @@ function addTriggerPayloadOptions(command) {
     []
   ).option(
     "--condition <field:comparator:value>",
-    "trigger condition",
+    "trigger condition (use field:comparator for comparators without value: chg, ie, ine)",
     collectValues,
     []
   ).option(
@@ -8031,7 +8085,12 @@ function addActionPayloadOptions(command) {
   return command.option(
     "--type <type>",
     "action type (create_record|update_record|search_records|send_message|http_request|execute_plugin|generate_document)"
-  ).option("--name <name>", "action name").option("--target-schema <uuid>", "target schema id").option("--map <field=value>", "field mapping", collectValues, []).option("--map-json <field=json>", "JSON field mapping", collectValues, []).option("--condition <field:comparator:value>", "action condition", collectValues, []).option("--condition-json <json>", "action condition as JSON", collectValues, []).option("--use-trigger-record", "use the triggering record").option("--method <method>", "HTTP method").option("--url <url>", "HTTP target URL").option("--header <key=value>", "HTTP header", collectValues, []).option("--body <json>", "HTTP request body as JSON").option("--body-file <path>", "path to HTTP request body JSON").option("--content-type <type>", "HTTP content type").option(
+  ).option("--name <name>", "action name").option("--target-schema <uuid>", "target schema id").option("--map <field=value>", "field mapping", collectValues, []).option("--map-json <field=json>", "JSON field mapping", collectValues, []).option(
+    "--condition <field:comparator:value>",
+    "action condition (use field:comparator for comparators without value: ie, ine)",
+    collectValues,
+    []
+  ).option("--condition-json <json>", "action condition as JSON", collectValues, []).option("--use-trigger-record", "use the triggering record").option("--method <method>", "HTTP method").option("--url <url>", "HTTP target URL").option("--header <key=value>", "HTTP header", collectValues, []).option("--body <json>", "HTTP request body as JSON").option("--body-file <path>", "path to HTTP request body JSON").option("--content-type <type>", "HTTP content type").option(
     "--timeout-ms <n>",
     "HTTP timeout in milliseconds",
     parseNonNegativeInteger
@@ -8136,7 +8195,7 @@ function registerAutomationsCommands(program, options = {}) {
     }
     printTable(
       automationRows(data),
-      ["id", "name", "status", "folderId", "triggerType", "actionCount"],
+      ["id", "name", "status", "triggerType", "actionCount", ...FOLDER_TABLE_KEYS],
       stdout
     );
   });
@@ -9247,7 +9306,8 @@ function displayRows(displays) {
     name: display.name ?? "",
     layoutTemplate: display.layoutTemplate ?? "",
     variableCount: display.variableCount ?? "",
-    widgetCount: display.widgetCount ?? ""
+    widgetCount: display.widgetCount ?? "",
+    ...folderColumns(display.folder)
   }));
 }
 function getDisplaySubresource(value) {
@@ -9497,7 +9557,11 @@ function registerDisplaysCommands(program, options = {}) {
       emitJson4(stdout, "displays list", data);
       return;
     }
-    printTable(displayRows(data), ["id", "name", "layoutTemplate", "variableCount", "widgetCount"], stdout);
+    printTable(
+      displayRows(data),
+      ["id", "name", "layoutTemplate", "variableCount", "widgetCount", ...FOLDER_TABLE_KEYS],
+      stdout
+    );
   });
   displays.command("get").description("Get a display").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).action(async function action(display) {
     const { api, json } = createDisplaysApi(this, filePath);
@@ -11888,9 +11952,10 @@ function emitSchemasTable(stdout, schemas) {
       name: schema.name ?? "",
       slug: schema.slug ?? "",
       auditable: schema.auditable ?? "",
-      commentable: schema.commentable ?? ""
+      commentable: schema.commentable ?? "",
+      ...folderColumns(schema.folder)
     })),
-    ["id", "name", "slug", "auditable", "commentable"],
+    ["id", "name", "slug", "auditable", "commentable", ...FOLDER_TABLE_KEYS],
     stdout
   );
 }