@neta-art/cohub-cli 3.10.0 → 3.10.2

package/dist/commands/public.js

@@ -169,6 +169,14 @@ function uploadFailure(errors) {
     const first = errors[0]?.message ?? "Upload failed";
     return new Error(`${first} (${errors.length} files failed)`);
 }
+function publicUrlPrefix(destination, entry) {
+    const encodedPath = entry.path.split("/").map(encodeURIComponent).join("/");
+    if (!entry.publicUrl.endsWith(encodedPath)) {
+        throw new Error(`Invalid public URL for ${entry.path}`);
+    }
+    const encodedDestination = destination.split("/").map(encodeURIComponent).join("/");
+    return `${entry.publicUrl.slice(0, -encodedPath.length)}${encodedDestination}`;
+}
 async function uploadPublic(command, source, destination, opts, deps) {
     const client = deps.createClient?.() ?? createClient();
     const spaceId = resolveSpace(command);
@@ -206,17 +214,28 @@ async function uploadPublic(command, source, destination, opts, deps) {
             if (entryErrors.length > 0)
                 throw uploadFailure(entryErrors);
         }
-        const entryUrl = entryPlan?.publicUrl ?? null;
+        const firstPlan = plan.entries[0];
+        if (!firstPlan)
+            throw new Error("Upload plan contains no files");
         if (jsonRequested(opts)) {
             outJson({
-                uploaded: upload.files.length,
-                overwrite: Boolean(opts.overwrite),
                 destination: upload.destination,
-                url: entryUrl,
+                urlPrefix: publicUrlPrefix("", firstPlan),
+                files: upload.files.map((file) => ({
+                    path: file.publicPath,
+                    size: file.size,
+                    mimeType: file.mimeType,
+                })),
             });
             return;
         }
-        console.log(entryUrl ?? `Uploaded ${upload.files.length} files to ${upload.destination}`);
+        if (entryPlan) {
+            console.log(entryPlan.publicUrl);
+            return;
+        }
+        const fileLabel = upload.files.length === 1 ? "file" : "files";
+        console.log(`Uploaded ${upload.files.length} ${fileLabel} to ${upload.destination}`);
+        console.log(`URL prefix: ${publicUrlPrefix(upload.destination, firstPlan)}`);
     }
     catch (exception) {
         handleHttp(exception);

package/dist/commands/references.js

@@ -1,3 +1,4 @@
+import { isUuid, } from "@neta-art/cohub";
 import { createClient } from "../client.js";
 import { table, json as outJson, jsonRequested, error, handleHttp } from "../output.js";
 const RESOURCE_TYPES = new Set([
@@ -22,7 +23,6 @@ const REFERENCE_KINDS = new Set([
 ]);
 const DIRECTIONS = new Set(["out", "in", "both"]);
 const GROUP_BYS = new Set(["kind", "targetType", "target", "sourceType", "day"]);
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 function parseSource(value) {
     const idx = value.indexOf(":");
     if (idx <= 0)
@@ -146,7 +146,7 @@ Examples:
         .action(async (spaceId, opts) => {
         const client = createClient();
         try {
-            if (!UUID_PATTERN.test(spaceId.trim()))
+            if (!isUuid(spaceId.trim()))
                 return error("Invalid space id");
             const groupBy = (opts.groupBy ?? "kind");
             if (!GROUP_BYS.has(groupBy))

package/dist/commands/search.js

@@ -1,10 +1,10 @@
+import { isUuid } from "@neta-art/cohub";
 import { createClient } from "../client.js";
 import { table, json as outJson, jsonRequested, error, handleHttp } from "../output.js";
 const DEFAULT_LIMIT = 20;
 const MAX_TITLE_LENGTH = 72;
 const MAX_CONTEXT_LENGTH = 42;
 const SEARCH_TYPES = new Set(["turn", "session", "space", "label"]);
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 function clampLimit(value) {
     const parsed = Number(value ?? DEFAULT_LIMIT);
     if (!Number.isFinite(parsed))
@@ -40,7 +40,7 @@ function parseTypes(value) {
 function parseSearchInput(opts) {
     const types = parseTypes(opts.types);
     const spaceId = opts.spaceId?.trim();
-    if (spaceId && !UUID_PATTERN.test(spaceId))
+    if (spaceId && !isUuid(spaceId))
         throw new Error("Invalid space id");
     return { types, spaceId: spaceId || undefined, labelRef: opts.labelRef?.trim() || undefined };
 }

package/dist/commands/works.js

@@ -87,6 +87,15 @@ function printWorkUrls(result) {
     if (lines.length)
         console.log(`\n${lines.join("\n")}`);
 }
+function promotionUrl(publicUrl, promotion) {
+    if (!publicUrl)
+        return null;
+    const url = new URL(publicUrl);
+    url.searchParams.set("cohub_campaign", promotion.id);
+    for (const [key, value] of Object.entries(promotion.parameters))
+        url.searchParams.set(key, value);
+    return url.toString();
+}
 function printWorkStats(stats) {
     table([stats.summary], [
         { key: "totalViews", label: "Total" },
@@ -424,6 +433,111 @@ export function registerWorks(program) {
             handleHttp(e);
         }
     });
+    const promotionsCmd = worksCmd.command("promotions").description("Work promotion links and analytics");
+    promotionsCmd
+        .command("list <work>")
+        .alias("ls")
+        .description("List promotion links")
+        .option("--json", "Output as JSON")
+        .action(async (workRef, opts) => {
+        const client = createClient();
+        try {
+            const detail = await getWorkByRef(client, workRef);
+            const result = await client.works.listPromotions(detail.work.id);
+            const promotions = result.promotions.map((promotion) => ({
+                ...promotion,
+                url: promotionUrl(detail.publicUrl, promotion),
+            }));
+            if (jsonRequested(opts))
+                return outJson({ ...result, promotions });
+            table(promotions, [
+                { key: "name", label: "Name" },
+                { key: "provider", label: "Provider" },
+                { key: "id", label: "ID" },
+                { key: "url", label: "URL" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    promotionsCmd
+        .command("create <work>")
+        .description("Create an immutable promotion link")
+        .requiredOption("--name <name>", "Promotion name")
+        .option("--provider <provider>", "Promotion provider", "generic")
+        .option("--utm-id <value>", "UTM campaign ID")
+        .option("--utm-source <value>", "UTM source")
+        .option("--utm-medium <value>", "UTM medium")
+        .option("--utm-campaign <value>", "UTM campaign")
+        .option("--utm-term <value>", "UTM term")
+        .option("--utm-content <value>", "UTM content")
+        .option("--json", "Output as JSON")
+        .action(async (workRef, opts) => {
+        const client = createClient();
+        try {
+            const detail = await getWorkByRef(client, workRef);
+            const parameters = Object.fromEntries(Object.entries({
+                utm_id: opts.utmId,
+                utm_source: opts.utmSource,
+                utm_medium: opts.utmMedium,
+                utm_campaign: opts.utmCampaign,
+                utm_term: opts.utmTerm,
+                utm_content: opts.utmContent,
+            }).filter((entry) => typeof entry[1] === "string"));
+            const result = await client.works.createPromotion(detail.work.id, {
+                name: opts.name,
+                provider: opts.provider,
+                parameters,
+            });
+            const url = promotionUrl(detail.publicUrl, result.promotion);
+            if (jsonRequested(opts))
+                return outJson({ ...result, url });
+            ok("Promotion created");
+            table([{ ...result.promotion, url }], [
+                { key: "name", label: "Name" },
+                { key: "provider", label: "Provider" },
+                { key: "id", label: "ID" },
+                { key: "url", label: "URL" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    promotionsCmd
+        .command("stats <work> <promotionId>")
+        .description("Show promotion analytics")
+        .option("--json", "Output as JSON")
+        .action(async (workRef, promotionId, opts) => {
+        const client = createClient();
+        try {
+            const detail = await getWorkByRef(client, workRef);
+            const result = await client.works.getPromotionStats(detail.work.id, promotionId);
+            if (jsonRequested(opts))
+                return outJson(result);
+            table([{
+                    name: result.promotion.name,
+                    landing: result.summary.landing,
+                    ready: result.summary.ready,
+                    registered: result.summary.registrationCompleted,
+                    paywall: result.summary.paywallViewed,
+                    checkout: result.summary.checkoutStarted,
+                    readyRate: `${(result.summary.readyRate * 100).toFixed(1)}%`,
+                }], [
+                { key: "name", label: "Name" },
+                { key: "landing", label: "Landing" },
+                { key: "ready", label: "Ready" },
+                { key: "registered", label: "Registered" },
+                { key: "paywall", label: "Paywall" },
+                { key: "checkout", label: "Checkout" },
+                { key: "readyRate", label: "Ready rate" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
     registerWorkCommerce(worksCmd);
     worksCmd
         .command("rm <id>")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "3.10.0",
+  "version": "3.10.2",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -19,7 +19,7 @@
     "commander": "^15.0.0",
     "pixi.js": "^8.19.0",
     "sharp": "^0.35.3",
-    "@neta-art/cohub": "5.8.0"
+    "@neta-art/cohub": "5.8.2"
   },
   "publishConfig": {
     "access": "public"