zinkee 0.1.39 → 0.1.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zinkee",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "description": "CLI for Zinkee API v2",
   "type": "module",
   "bin": {

package/src/api/automations.ts

@@ -16,6 +16,7 @@ export interface ApiAutomation {
   description?: string;
   status?: string;
   folderId?: string;
+  folder?: { id?: string; name?: string | null; isRoot?: boolean };
   trigger?: ApiAutomationTrigger;
   actions?: ApiAutomationAction[];
 }

package/src/api/displays.ts

@@ -16,6 +16,7 @@ export interface ApiDisplay {
   widgets?: Array<Record<string, unknown>>;
   navigationTargets?: Array<Record<string, unknown>>;
   crossWidgetFilter?: Array<Record<string, unknown>> | null;
+  folder?: { id?: string; name?: string | null; isRoot?: boolean };
 }
 
 export interface ApiDisplayTab {

package/src/api/schemas.ts

@@ -20,6 +20,7 @@ export interface ApiSchema {
   highlightedField?: string;
   fields?: ApiSchemaField[];
   uniqueFields?: string[];
+  folder?: { id?: string; name?: string | null; isRoot?: boolean };
 }
 
 export interface CreateSchemaInput {

package/src/commands/automations.ts

@@ -29,7 +29,7 @@ import {
 import { resolveRuntimeContext } from "../runtime-context.js";
 import type { JsonObject, JsonValue, RuntimeOverrides } from "../types.js";
 import { CliError } from "../utils/errors.js";
-import { buildJsonSuccess, printTable } from "../utils/output.js";
+import { buildJsonSuccess, folderColumns, FOLDER_TABLE_KEYS, printTable } from "../utils/output.js";
 
 interface CommandIo {
   write(chunk: string): unknown;
@@ -800,12 +800,12 @@ function automationRows(automations: readonly ApiAutomation[]): Record<string, u
     id: automation.id ?? "",
     name: automation.name ?? "",
     status: automation.status ?? "",
-    folderId: automation.folderId ?? "",
     triggerType:
       isJsonObject(automation.trigger) && typeof automation.trigger.type === "string"
         ? automation.trigger.type
         : "",
     actionCount: Array.isArray(automation.actions) ? automation.actions.length : "",
+    ...folderColumns(automation.folder),
   }));
 }
 
@@ -1569,7 +1569,7 @@ export function registerAutomationsCommands(
 
       printTable(
         automationRows(data),
-        ["id", "name", "status", "folderId", "triggerType", "actionCount"],
+        ["id", "name", "status", "triggerType", "actionCount", ...FOLDER_TABLE_KEYS],
         stdout,
       );
     });

package/src/commands/displays.ts

@@ -20,7 +20,7 @@ import { normalizeUuidOrSlug, type NormalizedUuidOrSlug } from "../parsers/selec
 import { resolveRuntimeContext } from "../runtime-context.js";
 import type { RuntimeOverrides } from "../types.js";
 import { CliError } from "../utils/errors.js";
-import { buildJsonSuccess, printTable } from "../utils/output.js";
+import { buildJsonSuccess, folderColumns, FOLDER_TABLE_KEYS, printTable } from "../utils/output.js";
 
 const DATE_DYNAMIC_OPTIONS =
   "today, thisWeek, thisMonth, thisQuarter, thisSemester, thisYear, next7Days, next30Days, next6Months, next12Months, last12Months";
@@ -628,6 +628,7 @@ function displayRows(displays: readonly DisplaySummary[]): Record<string, unknow
     layoutTemplate: display.layoutTemplate ?? "",
     variableCount: display.variableCount ?? "",
     widgetCount: display.widgetCount ?? "",
+    ...folderColumns(display.folder),
   }));
 }
 
@@ -953,7 +954,11 @@ export function registerDisplaysCommands(
         emitJson(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

package/src/commands/schemas.ts

@@ -31,7 +31,7 @@ import {
   normalizeSchemaFieldUpdatePayload,
   normalizeSchemaFieldType,
 } from "../utils/schema-fields.js";
-import { buildJsonSuccess, printTable } from "../utils/output.js";
+import { buildJsonSuccess, folderColumns, FOLDER_TABLE_KEYS, printTable } from "../utils/output.js";
 
 interface CommandIo {
   write(chunk: string): unknown;
@@ -284,8 +284,9 @@ function emitSchemasTable(stdout: CommandIo, schemas: readonly ApiSchema[]): voi
       slug: schema.slug ?? "",
       auditable: schema.auditable ?? "",
       commentable: schema.commentable ?? "",
+      ...folderColumns(schema.folder),
     })),
-    ["id", "name", "slug", "auditable", "commentable"],
+    ["id", "name", "slug", "auditable", "commentable", ...FOLDER_TABLE_KEYS],
     stdout,
   );
 }

package/src/utils/examples.test.ts

@@ -274,6 +274,8 @@ describe("getCommandExamples", () => {
     expect(examples[0]?.response).toContain('"layoutTemplate": "widget_row_tabs"');
     expect(examples[0]?.response).toContain('"layoutTemplate": "freeform"');
     expect(examples[0]?.response).toContain('"layoutTemplate": "grid"');
+    expect(examples[0]?.response).toContain('"folder"');
+    expect(examples[0]?.response).toContain('"isRoot": true');
   });
 
   it("attaches a response body to schemas create and teamspace resources publish", () => {

package/src/utils/examples.ts

@@ -2909,21 +2909,36 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "name": "Executive Revenue",
     "layoutTemplate": "widget_row_tabs",
     "variableCount": 3,
-    "widgetCount": 6
+    "widgetCount": 6,
+    "folder": {
+      "id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+      "name": "📊 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": "📊 Executive",
+      "isRoot": false
+    }
   }
 ]`,
     },
@@ -3056,7 +3071,12 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       "targetVariableId": "aaaaaaaa-1111-4111-a111-111111111111",
       "label": "Open customer"
     }
-  ]
+  ],
+  "folder": {
+    "id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
+    "name": "📊 Executive",
+    "isRoot": false
+  }
 }`,
     },
   ]),

package/src/utils/output.test.ts

@@ -2,7 +2,33 @@ import { describe, expect, it } from "vitest";
 
 import { getCommandMeta } from "../command-registry.js";
 
-import { buildJsonError, buildJsonSuccess } from "./output.js";
+import { buildJsonError, buildJsonSuccess, folderColumns } from "./output.js";
+
+describe("folderColumns", () => {
+  it("flattens a named folder into id/name/isRoot columns", () => {
+    expect(folderColumns({ id: "f1", name: "Finance", isRoot: false })).toEqual({
+      folderId: "f1",
+      folderName: "Finance",
+      folderIsRoot: "false",
+    });
+  });
+
+  it("renders the root folder (null name) as (root)", () => {
+    expect(folderColumns({ id: "root-1", name: null, isRoot: true })).toEqual({
+      folderId: "root-1",
+      folderName: "(root)",
+      folderIsRoot: "true",
+    });
+  });
+
+  it("leaves every column empty when there is no folder", () => {
+    expect(folderColumns(undefined)).toEqual({
+      folderId: "",
+      folderName: "",
+      folderIsRoot: "",
+    });
+  });
+});
 
 describe("buildJsonSuccess", () => {
   it("wraps data in the standard success envelope", () => {

package/src/utils/output.ts

@@ -59,6 +59,36 @@ export function buildTableColumns(keys: readonly string[]): readonly TableColumn
   return keys.map((key) => ({ key, label: key }));
 }
 
+export interface FolderLocation {
+  id?: string;
+  name?: string | null;
+  isRoot?: boolean;
+}
+
+/** Column keys, in order, produced by {@link folderColumns}. Append them to a table's key list. */
+export const FOLDER_TABLE_KEYS = ["folderId", "folderName", "folderIsRoot"] as const;
+
+/**
+ * Flattens the API `folder` object (`{ id, name, isRoot }`) into the folderId/folderName/folderIsRoot table columns.
+ * The root folder arrives with a null name, so folderName renders it as "(root)". A missing folder (e.g. a workspace
+ * without a default group) leaves every column empty.
+ */
+export function folderColumns(folder: FolderLocation | null | undefined): {
+  folderId: string;
+  folderName: string;
+  folderIsRoot: string;
+} {
+  if (!folder) {
+    return { folderId: "", folderName: "", folderIsRoot: "" };
+  }
+
+  return {
+    folderId: folder.id ?? "",
+    folderName: folder.name ?? (folder.isRoot === true ? "(root)" : ""),
+    folderIsRoot: folder.isRoot === undefined ? "" : String(folder.isRoot),
+  };
+}
+
 export function buildTableRows(
   rows: readonly Record<string, unknown>[],
   columns: readonly TableColumn[],