@neta-art/cohub-cli 3.6.4 → 3.7.0

package/README.md

@@ -276,6 +276,7 @@ cohub profile update --username <username>
 cohub spaces update <spaceId> --slug <space-slug>
 cohub -s <spaceId> works ls --json
 cohub works get <workId|url|username/space/work> --json
+cohub works stats <workId|url|username/space/work>
 cohub works download <workId|url|username/space/work> --output <path>
 cohub -s <spaceId> works publish demo --file dist/index.html
 cohub -s <spaceId> works publish site --dir dist
@@ -291,7 +292,7 @@ Resolve a published Work by public identity:
 cohub works resolve <workSlug> --owner <username> --space-slug <spaceSlug>
 ```
 
-Use `--json` for machine-readable output. `works get` and `works download` also accept `cohub://works/<username>/<space>/<work>` mention URIs. Download restores newly published file and directory artifacts directly from the CDN with checksum verification. HTML files with companion assets are restored as directory bundles; Board and port Works are not downloadable. The resolve command remains available for explicit slug-based lookup.
+Use `--json` for machine-readable output. `works get`, `works stats`, and `works download` also accept `cohub://works/<username>/<space>/<work>` mention URIs. `works stats` reports total, 24-hour, 7-day, and 30-day views with a source breakdown. Download restores newly published file and directory artifacts directly from the CDN with checksum verification. HTML files with companion assets are restored as directory bundles; Board and port Works are not downloadable. The resolve command remains available for explicit slug-based lookup.
 
 Realtime rooms use a published Work's runtime identity, so they are available
 through `client.work.realtime` in the SDK rather than as CLI commands.

package/dist/commands/works.d.ts

@@ -1,2 +1,4 @@
+import { type CohubHttpClient, type WorkViewStatsResponse } from "@neta-art/cohub";
 import type { Command } from "commander";
+export declare function getWorkStatsByRef(client: CohubHttpClient, work: string): Promise<WorkViewStatsResponse>;
 export declare function registerWorks(program: Command): void;

package/dist/commands/works.js

@@ -3,7 +3,7 @@ import { createClient } from "../client.js";
 import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
 import { resolveSpace } from "../space.js";
 import { downloadWork } from "../work-download.js";
-import { getWorkByRef } from "../work-ref.js";
+import { getWorkByRef, parseWorkRef } from "../work-ref.js";
 import { registerWorkCommerce } from "./work-commerce.js";
 const WORK_STATUSES = ["published", "disabled"];
 const WORK_VISIBILITIES = ["public", "space"];
@@ -87,6 +87,28 @@ function printWorkUrls(result) {
     if (lines.length)
         console.log(`\n${lines.join("\n")}`);
 }
+function printWorkStats(stats) {
+    table([stats.summary], [
+        { key: "totalViews", label: "Total" },
+        { key: "views24h", label: "24h" },
+        { key: "views7d", label: "7d" },
+        { key: "views30d", label: "30d" },
+    ]);
+    if (stats.sources.length) {
+        console.log("");
+        table(stats.sources, [
+            { key: "source", label: "Source" },
+            { key: "views", label: "Views" },
+        ]);
+    }
+}
+export async function getWorkStatsByRef(client, work) {
+    const ref = parseWorkRef(work);
+    if ("id" in ref)
+        return client.works.getStats(ref.id);
+    const detail = await getWorkByRef(client, work);
+    return client.works.getStats(detail.work.id);
+}
 async function confirmDelete(opts) {
     if (opts.yes)
         return;
@@ -161,6 +183,22 @@ export function registerWorks(program) {
             handleHttp(e);
         }
     });
+    worksCmd
+        .command("stats <work>")
+        .description("Show view statistics by id, URL, mention URI, or username/space/work")
+        .option("--json", "Output as JSON")
+        .action(async (work, opts) => {
+        const client = createClient();
+        try {
+            const result = await getWorkStatsByRef(client, work);
+            if (jsonRequested(opts))
+                return outJson(result);
+            printWorkStats(result);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
     worksCmd
         .command("download <work>")
         .description("Download a published file or directory Work")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "3.6.4",
+  "version": "3.7.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -15,7 +15,7 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@neta-art/generation": "^0.1.18",
+    "@neta-art/generation": "^0.1.19",
     "commander": "^15.0.0",
     "pixi.js": "^8.19.0",
     "sharp": "^0.35.3",