zinkee 0.1.38 → 0.1.40

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[],