@nocoo/zhe 1.16.1 → 1.18.0

package/dist/commands/tag.js

@@ -0,0 +1,289 @@
+/**
+ * zhe tag — Manage tags (create, update, delete, list)
+ *
+ * The plural `zhe tags` command (list-only) is preserved for back-compat;
+ * `zhe tag list` is provided as the consistent alias.
+ */
+import * as readline from "node:readline";
+import { defineCommand, pc } from "@nocoo/cli-base";
+import { ApiClient, ApiClientError, EXIT_AUTH_REQUIRED, EXIT_ERROR, EXIT_INVALID_ARGS, EXIT_NOT_FOUND, EXIT_RATE_LIMITED, } from "../api/client.js";
+import { getApiKey } from "../config.js";
+import { formatTagsTable, resolveTagRef } from "../utils.js";
+// ── Helpers ──
+function requireAuth() {
+    const apiKey = getApiKey();
+    if (!apiKey) {
+        console.log(pc.red("Not authenticated. Run `zhe login` first."));
+        process.exit(EXIT_AUTH_REQUIRED);
+    }
+    return apiKey;
+}
+function handleApiError(error) {
+    if (error instanceof ApiClientError) {
+        if (error.status === 404) {
+            console.log(pc.red("Tag not found."));
+            process.exit(EXIT_NOT_FOUND);
+        }
+        console.log(pc.red(`Error: ${error.message}`));
+        if (error.status === 401) {
+            process.exit(EXIT_AUTH_REQUIRED);
+        }
+        if (error.status === 429) {
+            process.exit(EXIT_RATE_LIMITED);
+        }
+        process.exit(EXIT_ERROR);
+    }
+    throw error;
+}
+async function confirm(message) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(`${message} [y/N] `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y");
+        });
+    });
+}
+const HEX_COLOR_PATTERN = /^#?[0-9A-Fa-f]{6}$/;
+/**
+ * Validate hex color and normalize to `#rrggbb` form.
+ * Returns null with an error printed if invalid.
+ */
+function normalizeColor(input) {
+    if (!HEX_COLOR_PATTERN.test(input)) {
+        console.log(pc.red("--color must be a 6-digit hex color (e.g. '#3b82f6' or 'ff5500')."));
+        return null;
+    }
+    return input.startsWith("#") ? input : `#${input}`;
+}
+// ── Subcommands ──
+const listSubcommand = defineCommand({
+    meta: {
+        name: "list",
+        description: "List all tags",
+    },
+    args: {
+        json: {
+            type: "boolean",
+            description: "Output as JSON",
+        },
+    },
+    async run({ args }) {
+        const apiKey = requireAuth();
+        const client = new ApiClient(apiKey);
+        try {
+            const response = await client.listTags();
+            if (args.json) {
+                console.log(JSON.stringify(response, null, 2));
+                return;
+            }
+            if (response.tags.length === 0) {
+                console.log(pc.dim("No tags found."));
+                return;
+            }
+            console.log(formatTagsTable(response.tags));
+        }
+        catch (error) {
+            handleApiError(error);
+        }
+    },
+});
+const createSubcommand = defineCommand({
+    meta: {
+        name: "create",
+        description: "Create a new tag",
+    },
+    args: {
+        name: {
+            type: "positional",
+            description: "Tag name",
+            required: true,
+        },
+        color: {
+            type: "string",
+            alias: "c",
+            description: "Tag color as 6-digit hex (e.g. '#3b82f6' or 'ff5500')",
+            required: true,
+        },
+        json: {
+            type: "boolean",
+            description: "Output as JSON",
+        },
+    },
+    async run({ args }) {
+        const apiKey = requireAuth();
+        const client = new ApiClient(apiKey);
+        const name = args.name.trim();
+        if (!name) {
+            console.log(pc.red("Tag name cannot be empty."));
+            process.exit(EXIT_INVALID_ARGS);
+        }
+        const color = normalizeColor(args.color);
+        if (color === null) {
+            process.exit(EXIT_INVALID_ARGS);
+        }
+        const request = { name, color };
+        try {
+            const response = await client.createTag(request);
+            if (args.json) {
+                console.log(JSON.stringify(response, null, 2));
+                return;
+            }
+            const { tag } = response;
+            console.log(pc.green(`✓ Created tag ${pc.cyan(tag.name)} ${pc.dim(`(${tag.id})`)} ${tag.color}`));
+        }
+        catch (error) {
+            handleApiError(error);
+        }
+    },
+});
+const updateSubcommand = defineCommand({
+    meta: {
+        name: "update",
+        description: "Update a tag (rename or change color)",
+    },
+    args: {
+        ref: {
+            type: "positional",
+            description: "Tag name or UUID",
+            required: true,
+        },
+        name: {
+            type: "string",
+            alias: "n",
+            description: "New tag name",
+        },
+        color: {
+            type: "string",
+            alias: "c",
+            description: "New color as 6-digit hex (e.g. '#3b82f6' or 'ff5500')",
+        },
+        json: {
+            type: "boolean",
+            description: "Output as JSON",
+        },
+    },
+    async run({ args }) {
+        const apiKey = requireAuth();
+        const client = new ApiClient(apiKey);
+        const ref = args.ref;
+        const request = {};
+        if (args.name !== undefined) {
+            const trimmed = args.name.trim();
+            if (!trimmed) {
+                console.log(pc.red("--name cannot be empty."));
+                process.exit(EXIT_INVALID_ARGS);
+            }
+            request.name = trimmed;
+        }
+        if (args.color !== undefined) {
+            const color = normalizeColor(args.color);
+            if (color === null) {
+                process.exit(EXIT_INVALID_ARGS);
+            }
+            request.color = color;
+        }
+        if (Object.keys(request).length === 0) {
+            console.log(pc.yellow("No changes specified. Pass --name and/or --color."));
+            process.exit(EXIT_INVALID_ARGS);
+        }
+        try {
+            const resolved = await resolveTagRef(client, ref);
+            if (resolved.kind === "not_found") {
+                console.log(pc.red(`Tag not found: ${ref}.`));
+                process.exit(EXIT_NOT_FOUND);
+            }
+            if (resolved.kind === "ambiguous") {
+                console.log(pc.red(`Multiple tags match "${ref}". Please use the tag ID or rename duplicates.`));
+                process.exit(EXIT_INVALID_ARGS);
+            }
+            const response = await client.updateTag(resolved.id, request);
+            if (args.json) {
+                console.log(JSON.stringify(response, null, 2));
+                return;
+            }
+            const { tag } = response;
+            console.log(pc.green(`✓ Updated tag ${pc.cyan(tag.name)} ${pc.dim(`(${tag.id})`)} ${tag.color}`));
+        }
+        catch (error) {
+            handleApiError(error);
+        }
+    },
+});
+const deleteSubcommand = defineCommand({
+    meta: {
+        name: "delete",
+        description: "Delete a tag",
+    },
+    args: {
+        ref: {
+            type: "positional",
+            description: "Tag name or UUID",
+            required: true,
+        },
+        yes: {
+            type: "boolean",
+            alias: "y",
+            description: "Skip confirmation prompt",
+        },
+        json: {
+            type: "boolean",
+            description: "Output as JSON",
+        },
+    },
+    async run({ args }) {
+        const apiKey = requireAuth();
+        const client = new ApiClient(apiKey);
+        const ref = args.ref;
+        try {
+            const resolved = await resolveTagRef(client, ref);
+            if (resolved.kind === "not_found") {
+                console.log(pc.red(`Tag not found: ${ref}.`));
+                process.exit(EXIT_NOT_FOUND);
+            }
+            if (resolved.kind === "ambiguous") {
+                console.log(pc.red(`Multiple tags match "${ref}". Please use the tag ID or rename duplicates.`));
+                process.exit(EXIT_INVALID_ARGS);
+            }
+            const { id: tagId, name: tagName } = resolved;
+            const tagLabel = tagName ?? tagId;
+            if (!args.yes) {
+                if (!process.stdin.isTTY) {
+                    console.log(pc.red("Refusing to delete without --yes in non-interactive mode."));
+                    process.exit(EXIT_INVALID_ARGS);
+                }
+                const confirmed = await confirm(`Delete tag "${tagLabel}" (${tagId})?`);
+                if (!confirmed) {
+                    console.log(pc.dim("Cancelled."));
+                    return;
+                }
+            }
+            await client.deleteTag(tagId);
+            if (args.json) {
+                console.log(JSON.stringify({ success: true, id: tagId, name: tagName ?? null }, null, 2));
+                return;
+            }
+            console.log(pc.green(`✓ Deleted tag ${pc.cyan(tagLabel)} ${pc.dim(`(${tagId})`)}`));
+        }
+        catch (error) {
+            handleApiError(error);
+        }
+    },
+});
+// ── Main command ──
+export const tagCommand = defineCommand({
+    meta: {
+        name: "tag",
+        description: "Manage tags (create, update, delete, list)",
+    },
+    subCommands: {
+        create: createSubcommand,
+        update: updateSubcommand,
+        delete: deleteSubcommand,
+        list: listSubcommand,
+    },
+});
+//# sourceMappingURL=tag.js.map

package/dist/commands/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../src/commands/tag.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -5,6 +5,7 @@
 import { defineCommand, runMain } from "@nocoo/cli-base";
 import { createCommand } from "./commands/create.js";
 import { deleteCommand } from "./commands/delete.js";
+import { folderCommand } from "./commands/folder.js";
 import { foldersCommand } from "./commands/folders.js";
 import { getCommand } from "./commands/get.js";
 import { ideaCommand } from "./commands/idea.js";
@@ -13,6 +14,7 @@ import { listCommand } from "./commands/list.js";
 import { loginCommand } from "./commands/login.js";
 import { logoutCommand } from "./commands/logout.js";
 import { openCommand } from "./commands/open.js";
+import { tagCommand } from "./commands/tag.js";
 import { tagsCommand } from "./commands/tags.js";
 import { updateCommand } from "./commands/update.js";
 import { CLI_VERSION } from "./version.js";
@@ -28,7 +30,9 @@ const main = defineCommand({
         list: listCommand,
         inbox: inboxCommand,
         folders: foldersCommand,
+        folder: folderCommand,
         tags: tagsCommand,
+        tag: tagCommand,
         idea: ideaCommand,
         create: createCommand,
         get: getCommand,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,IAAI,GAAG,aAAa,CAAC;IAC1B,IAAI,EAAE;QACL,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,qCAAqC;KAClD;IACD,WAAW,EAAE;QACZ,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;KACjB;CACD,CAAC,CAAC;AAEH,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,IAAI,GAAG,aAAa,CAAC;IAC1B,IAAI,EAAE;QACL,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,qCAAqC;KAClD;IACD,WAAW,EAAE;QACZ,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,UAAU;QACf,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;KACjB;CACD,CAAC,CAAC;AAEH,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/utils.d.ts

@@ -29,6 +29,8 @@ export declare function truncate(str: string, maxLength: number): string;
 export interface FormatLinksTableOptions {
     wide?: boolean;
     folderMap?: Map<string, string>;
+    tagMap?: Map<string, string>;
+    showTags?: boolean;
 }
 /**
  * Format links as a table
@@ -42,10 +44,13 @@ export declare function formatLinksMinimal(links: Link[]): string;
  * Format a single link for detailed display
  * @param link - The link to format
  * @param folderName - Optional folder name (if not provided, shows folder ID)
+ * @param tagMap - Optional map of tagId → name (falls back to tagId if missing)
  */
-export declare function formatLinkDetail(link: Link, folderName?: string): string;
+export declare function formatLinkDetail(link: Link, folderName?: string, tagMap?: Map<string, string>): string;
+export declare function parsePositiveInt(input: string): number | null;
 /**
- * Parse a link ID from string, return null if invalid
+ * Parse a link ID from string, return null if invalid.
+ * Uses strict positive-integer parsing.
  */
 export declare function parseLinkId(input: string): number | null;
 /**
@@ -62,10 +67,39 @@ export declare function formatTagsTable(tags: Tag[]): string;
  * Returns null if folder is not found (with error message printed).
  */
 export declare function resolveFolderName(client: ApiClient, input: string): Promise<string | null>;
+/**
+ * Open a URL in the default browser.
+ * Uses spawn() with argv to prevent shell injection.
+ */
+export declare function openInBrowser(url: string): void;
 /**
  * Resolve a tag name to tag ID via API.
  * If input looks like a UUID, use it directly.
  * Returns null if tag is not found (with error message printed).
  */
 export declare function resolveTagName(client: ApiClient, input: string): Promise<string | null>;
+/**
+ * Resolve a tag reference (name or UUID) to its canonical id + name.
+ *
+ * Unlike `resolveTagName`, this:
+ *   - Distinguishes `not_found` (zero matches) from `ambiguous` (multiple
+ *     name matches), letting callers map them to different exit codes.
+ *   - For UUID input, returns immediately without calling `listTags()` so
+ *     that API keys with only `tags:write` (no `tags:read`) can still
+ *     update/delete by ID. The server is the source of truth for whether
+ *     the tag exists. `name` is `undefined` in that case; callers should
+ *     fall back to the UUID in any prompt text.
+ *
+ * Does NOT print any error itself — callers decide messaging and exit codes.
+ */
+export type TagRef = {
+    kind: "found";
+    id: string;
+    name: string | undefined;
+} | {
+    kind: "not_found";
+} | {
+    kind: "ambiguous";
+};
+export declare function resolveTagRef(client: ApiClient, input: string): Promise<TagRef>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAExD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,GAAE,uBAA4B,GACnC,MAAM,CAyDR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAKxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBxE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAmB5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAkBnD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8BxB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4BxB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAExD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,GAAE,uBAA4B,GACnC,MAAM,CA+ER;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAKxD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,IAAI,EACV,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,MAAM,CAmCR;AAUD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAmB5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAkBnD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8BxB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAgC/C;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4BxB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,MAAM,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAEzB,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/utils.js

@@ -1,6 +1,7 @@
 /**
  * Shared utilities for zhe CLI
  */
+import { spawn } from "node:child_process";
 import { pc } from "@nocoo/cli-base";
 /**
  * Mask an API key for display: zhe_abcd...wxyz
@@ -50,13 +51,27 @@ export function formatLinksTable(links, options = {}) {
     if (links.length === 0) {
         return "No links found.";
     }
-    const { wide = false, folderMap } = options;
+    const { wide = false, folderMap, tagMap, showTags = false } = options;
     const showFolders = links.some((l) => l.folderId);
+    const formatTags = (link) => {
+        // Prefer embedded tags (carries names) — avoids needing a tagMap
+        // fetch from the caller when /links already returned tag details.
+        if (link.tags && link.tags.length > 0) {
+            return link.tags.map((t) => t.name).join(",");
+        }
+        const ids = link.tagIds ?? [];
+        if (ids.length === 0)
+            return "";
+        return ids.map((id) => tagMap?.get(id) ?? id.slice(0, 8)).join(",");
+    };
     if (wide) {
         // Wide mode: no truncation
-        const header = showFolders
-            ? "ID     SLUG                 URL                                              FOLDER           CLICKS  CREATED"
-            : "ID     SLUG                 URL                                              CLICKS  CREATED";
+        let header = "ID     SLUG                 URL                                              ";
+        if (showFolders)
+            header += "FOLDER           ";
+        if (showTags)
+            header += "TAGS                       ";
+        header += "CLICKS  CREATED";
         const separator = "─".repeat(header.length);
         const rows = links.map((link) => {
             const id = String(link.id).padEnd(6);
@@ -64,21 +79,28 @@ export function formatLinksTable(links, options = {}) {
             const url = link.originalUrl.padEnd(48);
             const clicks = String(link.clicks).padEnd(7);
             const created = formatDate(link.createdAt);
+            let row = `${id} ${slug} ${url} `;
             if (showFolders) {
                 const folderName = link.folderId
                     ? (folderMap?.get(link.folderId) ?? link.folderId.slice(0, 8))
                     : "";
-                const folder = folderName.padEnd(16);
-                return `${id} ${slug} ${url} ${folder} ${clicks} ${created}`;
+                row += `${folderName.padEnd(16)} `;
+            }
+            if (showTags) {
+                row += `${formatTags(link).padEnd(26)} `;
             }
-            return `${id} ${slug} ${url} ${clicks} ${created}`;
+            row += `${clicks} ${created}`;
+            return row;
         });
         return [header, separator, ...rows].join("\n");
     }
     // Default compact mode with truncation
-    const header = showFolders
-        ? "ID     SLUG        URL                              FOLDER       CLICKS  CREATED"
-        : "ID     SLUG        URL                              CLICKS  CREATED";
+    let header = "ID     SLUG        URL                              ";
+    if (showFolders)
+        header += "FOLDER       ";
+    if (showTags)
+        header += "TAGS         ";
+    header += "CLICKS  CREATED";
     const separator = "─".repeat(header.length);
     const rows = links.map((link) => {
         const id = String(link.id).padEnd(6);
@@ -86,14 +108,18 @@ export function formatLinksTable(links, options = {}) {
         const url = truncate(link.originalUrl, 32).padEnd(32);
         const clicks = String(link.clicks).padEnd(7);
         const created = formatDate(link.createdAt);
+        let row = `${id} ${slug} ${url} `;
         if (showFolders) {
             const folderName = link.folderId
                 ? (folderMap?.get(link.folderId) ?? link.folderId.slice(0, 8))
                 : "";
-            const folder = truncate(folderName, 12).padEnd(12);
-            return `${id} ${slug} ${url} ${folder} ${clicks} ${created}`;
+            row += `${truncate(folderName, 12).padEnd(12)} `;
+        }
+        if (showTags) {
+            row += `${truncate(formatTags(link), 12).padEnd(12)} `;
         }
-        return `${id} ${slug} ${url} ${clicks} ${created}`;
+        row += `${clicks} ${created}`;
+        return row;
     });
     return [header, separator, ...rows].join("\n");
 }
@@ -110,8 +136,9 @@ export function formatLinksMinimal(links) {
  * Format a single link for detailed display
  * @param link - The link to format
  * @param folderName - Optional folder name (if not provided, shows folder ID)
+ * @param tagMap - Optional map of tagId → name (falls back to tagId if missing)
  */
-export function formatLinkDetail(link, folderName) {
+export function formatLinkDetail(link, folderName, tagMap) {
     const lines = [
         `Link #${link.id}`,
         "",
@@ -124,6 +151,16 @@ export function formatLinkDetail(link, folderName) {
         const folderDisplay = folderName ?? link.folderId;
         lines.push(`  Folder:       ${folderDisplay}`);
     }
+    if (link.tags && link.tags.length > 0) {
+        lines.push(`  Tags:         ${link.tags.map((t) => t.name).join(", ")}`);
+    }
+    else {
+        const tagIds = link.tagIds ?? [];
+        if (tagIds.length > 0) {
+            const tagDisplay = tagIds.map((id) => tagMap?.get(id) ?? id).join(", ");
+            lines.push(`  Tags:         ${tagDisplay}`);
+        }
+    }
     if (link.note) {
         lines.push(`  Note:         ${link.note}`);
     }
@@ -132,15 +169,29 @@ export function formatLinkDetail(link, folderName) {
     return lines.join("\n");
 }
 /**
- * Parse a link ID from string, return null if invalid
+ * Strict positive-integer parser.
+ * Rejects empty strings, 0, negatives, decimals, scientific notation,
+ * hex literals, and any junk-suffixed input (e.g. "12abc", "1e2", "0x10").
+ * Only accepts decimal digit sequences without a leading zero.
  */
-export function parseLinkId(input) {
-    const id = Number.parseInt(input, 10);
-    if (Number.isNaN(id) || id <= 0) {
+const STRICT_POSITIVE_INT = /^[1-9]\d*$/;
+export function parsePositiveInt(input) {
+    if (!STRICT_POSITIVE_INT.test(input)) {
+        return null;
+    }
+    const id = Number(input);
+    if (!Number.isSafeInteger(id) || id <= 0) {
         return null;
     }
     return id;
 }
+/**
+ * Parse a link ID from string, return null if invalid.
+ * Uses strict positive-integer parsing.
+ */
+export function parseLinkId(input) {
+    return parsePositiveInt(input);
+}
 /**
  * Format folders as a table
  */
@@ -203,6 +254,43 @@ export async function resolveFolderName(client, input) {
     }
     return matches[0].id;
 }
+/**
+ * Open a URL in the default browser.
+ * Uses spawn() with argv to prevent shell injection.
+ */
+export function openInBrowser(url) {
+    const platform = process.platform;
+    let command;
+    let args;
+    if (platform === "darwin") {
+        command = "open";
+        args = [url];
+    }
+    else if (platform === "linux") {
+        command = "xdg-open";
+        args = [url];
+    }
+    else if (platform === "win32") {
+        command = "cmd";
+        args = ["/c", "start", "", url];
+    }
+    else {
+        console.log(pc.dim(`Unable to open browser on ${platform}. Visit: ${url}`));
+        return;
+    }
+    const child = spawn(command, args, { stdio: "ignore" });
+    const fallback = () => console.log(pc.dim(`Failed to open browser. Visit: ${url}`));
+    let failed = false;
+    child.on("error", () => {
+        failed = true;
+        fallback();
+    });
+    child.on("close", (code) => {
+        if (!failed && code !== 0) {
+            fallback();
+        }
+    });
+}
 /**
  * Resolve a tag name to tag ID via API.
  * If input looks like a UUID, use it directly.
@@ -226,4 +314,25 @@ export async function resolveTagName(client, input) {
     }
     return matches[0].id;
 }
+export async function resolveTagRef(client, input) {
+    const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidPattern.test(input)) {
+        // Trust the UUID; let the destructive op's PATCH/DELETE be the
+        // authoritative existence check. Avoids requiring tags:read.
+        // Normalize to lowercase: tag IDs are stored lowercase, but the
+        // regex accepts uppercase (RFC 4122 allows either case in
+        // notation). The DB is `WHERE id = ?` text-equal, so an
+        // uppercase UUID would 404 on a tag that actually exists.
+        return { kind: "found", id: input.toLowerCase(), name: undefined };
+    }
+    const { tags } = await client.listTags();
+    const matches = tags.filter((t) => t.name.toLowerCase() === input.toLowerCase());
+    if (matches.length === 0) {
+        return { kind: "not_found" };
+    }
+    if (matches.length > 1) {
+        return { kind: "ambiguous" };
+    }
+    return { kind: "found", id: matches[0].id, name: matches[0].name };
+}
 //# sourceMappingURL=utils.js.map