@neta-art/cohub-cli 2.1.0 → 2.2.1

package/dist/commands/space-commerce.js

@@ -5,6 +5,7 @@ const PRODUCT_STATUSES = ["draft", "active"];
 const PRODUCT_UPDATE_STATUSES = ["draft", "active", "archived"];
 const PRODUCT_VISIBILITIES = ["public", "private"];
 const BENEFIT_STATUSES = ["active", "archived"];
+const MIN_PRODUCT_AMOUNT_USD = 0.5;
 function requireText(value, label, flag) {
     const text = value?.trim();
     if (text)
@@ -35,11 +36,13 @@ function parseInteger(value, label, options) {
 function parseAmountUsd(value) {
     const text = requireText(value, "amount", "--amount-usd <amount>");
     if (!/^(?:\d+|\d+\.\d{1,2}|\.\d{1,2})$/.test(text)) {
-        return error("Invalid amount", "--amount-usd must be a non-negative USD amount with at most 2 decimals.");
+        return error("Invalid amount", "--amount-usd must be a USD amount with at most 2 decimals.");
     }
     const amount = Number(text);
     if (!Number.isFinite(amount))
         return error("Invalid amount", "--amount-usd must be a finite USD amount.");
+    if (amount < MIN_PRODUCT_AMOUNT_USD)
+        return error("Invalid amount", "--amount-usd must be at least 0.5.");
     return amount;
 }
 function parseMetadataJson(value) {
@@ -83,25 +86,39 @@ function printProducts(products) {
         status: product.status,
         visibility: product.visibility,
         price: formatUsd(product.pricing.amountUsd),
+        credits: product.display.creditsAmount ?? "",
     })), [
         { key: "key", label: "Key" },
         { key: "name", label: "Name" },
         { key: "status", label: "Status" },
         { key: "visibility", label: "Visibility" },
         { key: "price", label: "Price" },
+        { key: "credits", label: "Credits" },
     ]);
 }
 function printBenefits(benefits) {
-    table(benefits.map((benefit) => ({
-        key: benefit.key,
-        name: benefit.name,
-        status: benefit.status,
-        description: benefit.description ?? "",
-    })), [
+    table(benefits.map((benefit) => {
+        let detail;
+        if (benefit.type === "credits") {
+            const config = benefit.config;
+            detail = `${config.amount} credits${config.expiresInDays != null ? ` · ${config.expiresInDays}d` : ""}`;
+        }
+        else {
+            detail = JSON.stringify(benefit.config.metadata);
+        }
+        return {
+            key: benefit.key,
+            name: benefit.name,
+            type: benefit.type,
+            status: benefit.status,
+            detail,
+        };
+    }), [
         { key: "key", label: "Key" },
         { key: "name", label: "Name" },
+        { key: "type", label: "Type" },
         { key: "status", label: "Status" },
-        { key: "description", label: "Description" },
+        { key: "detail", label: "Detail" },
     ]);
 }
 function printOrders(orders) {
@@ -303,13 +320,46 @@ Examples:
         .option("--benefit-key <key>", "Benefit key override")
         .option("--name <name>", "Benefit name")
         .option("--description <text>", "Benefit description")
-        .option("--metadata-json <json>", "Benefit metadata JSON object")
+        .option("--type <type>", "Benefit type: feature, credits (default: feature)")
+        .option("--amount <n>", "Credit amount (credits type only)")
+        .option("--expires-in-days <n>", "Credit expiry in days (credits type only)")
+        .option("--metadata-json <json>", "Benefit metadata JSON object (feature type only)")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
+        const name = requireText(opts.name, "name", "--name <name>");
+        const type = parseChoice(opts.type, "type", ["feature", "credits"]) ?? "feature";
+        if (type === "credits") {
+            const amount = parseInteger(opts.amount, "amount", { fallback: 0, min: 1 });
+            if (amount < 1)
+                return error("Missing amount", "Pass --amount <n> with a positive integer for credits benefits.");
+            const input = {
+                key: opts.benefitKey?.trim() || undefined,
+                name,
+                description: opts.description,
+                type: "credits",
+                amount,
+                expiresInDays: opts.expiresInDays !== undefined
+                    ? parseInteger(opts.expiresInDays, "expires-in-days", { fallback: 0, min: 1 })
+                    : undefined,
+            };
+            const { commerce } = commerceClient(spacesCmd);
+            try {
+                const result = await commerce.createBenefit(input);
+                if (jsonRequested(opts))
+                    return outJson(result);
+                ok(`Benefit created: ${result.benefit.key}`);
+                printBenefits([result.benefit]);
+            }
+            catch (e) {
+                handleHttp(e);
+            }
+            return;
+        }
         const input = {
             key: opts.benefitKey?.trim() || undefined,
-            name: requireText(opts.name, "name", "--name <name>"),
+            name,
             description: opts.description,
+            type: "feature",
             metadata: parseMetadataJson(opts.metadataJson),
         };
         const { commerce } = commerceClient(spacesCmd);

package/dist/commands/work-commerce.js

@@ -28,26 +28,27 @@ function printProducts(products) {
         status: product.status,
         visibility: product.visibility,
         price: formatUsd(product.pricing.amountUsd),
+        credits: product.display.creditsAmount ?? "",
     })), [
         { key: "key", label: "Key" },
         { key: "name", label: "Name" },
         { key: "status", label: "Status" },
         { key: "visibility", label: "Visibility" },
         { key: "price", label: "Price" },
+        { key: "credits", label: "Credits" },
     ]);
 }
-function printEntitlements(entitlements) {
-    table(entitlements.map((item) => ({
+function printEntitlements(result) {
+    table(result.entitlements.map((item) => ({
         benefitKey: item.benefitKey,
         enabled: item.enabled ? "yes" : "no",
-        reason: item.reason,
         metadata: item.metadata ? JSON.stringify(item.metadata) : "",
     })), [
         { key: "benefitKey", label: "Benefit" },
         { key: "enabled", label: "Enabled" },
-        { key: "reason", label: "Reason" },
         { key: "metadata", label: "Metadata" },
     ]);
+    console.log(`\nCredits available: ${result.credits.available} (net: ${result.credits.net})`);
 }
 function printOrder(order) {
     table([{
@@ -71,15 +72,16 @@ function printOrder(order) {
 export function registerWorkCommerce(worksCmd) {
     const commerceCmd = worksCmd
         .command("commerce")
-        .description("Debug work commerce")
+        .description("Work commerce operations")
         .addHelpText("after", `
 Examples:
   cohub works commerce products resolve --work-id <work-id> --product-key pro_pack
-  cohub works commerce entitlements check --work-id <work-id> --benefit-key premium_export
+  cohub works commerce entitlements --work-id <work-id>
+  cohub works commerce credits consume --work-id <work-id> --amount 100
 `);
     const productsCmd = commerceCmd
         .command("products")
-        .description("Debug commerce products");
+        .description("Resolve commerce products");
     productsCmd
         .command("resolve")
         .description("Resolve public products for a work")
@@ -100,25 +102,64 @@ Examples:
             handleHttp(e);
         }
     });
-    const entitlementsCmd = commerceCmd
+    commerceCmd
         .command("entitlements")
-        .description("Debug commerce entitlements");
-    entitlementsCmd
-        .command("check")
-        .description("Check viewer entitlements for a work")
+        .description("Show viewer entitlements and credit balance for a work")
         .option("--work-id <id>", "Work ID")
-        .option("--benefit-key <key>", "Benefit key", collectOption)
         .option("--json", "Output as JSON")
         .action(async (opts) => {
         const workId = requireText(opts.workId, "work ID", "--work-id <id>");
-        const benefitKeys = requireList(opts.benefitKey, "benefit key", "--benefit-key <key>");
         const client = createClient();
         try {
-            const result = await client.workCommerce.checkEntitlements(workId, { benefitKeys });
+            const result = await client.workCommerce.getEntitlements(workId);
             if (jsonRequested(opts))
                 return outJson(result);
-            printEntitlements(result.entitlements);
-            console.log(`\nChecked at: ${result.checkedAt}`);
+            printEntitlements(result);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    const creditsCmd = commerceCmd
+        .command("credits")
+        .description("Consume credits for a work");
+    creditsCmd
+        .command("consume")
+        .description("Consume credits for a work (self by default)")
+        .option("--work-id <id>", "Work ID")
+        .option("--amount <n>", "Positive integer credit amount")
+        .option("--operation-id <id>", "Idempotency key (generated when omitted)")
+        .option("--reason <text>", "Reason for the consumption")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const workId = requireText(opts.workId, "work ID", "--work-id <id>");
+        const amountText = requireText(opts.amount, "amount", "--amount <n>");
+        const amount = Number.parseInt(amountText, 10);
+        if (!Number.isSafeInteger(amount) || amount <= 0) {
+            return error("Invalid amount", "--amount must be a positive integer.");
+        }
+        const operationId = opts.operationId?.trim() || crypto.randomUUID();
+        const client = createClient();
+        try {
+            const result = await client.workCommerce.consumeCredits(workId, {
+                amount,
+                operationId,
+                reason: opts.reason,
+            });
+            if (jsonRequested(opts))
+                return outJson({ ...result, operationId });
+            ok(`Consumed ${result.amount} credits (operation: ${operationId})`);
+            table([{
+                    status: result.status,
+                    amount: result.amount,
+                    remaining: result.remaining,
+                    shortfall: result.shortfall ?? "",
+                }], [
+                { key: "status", label: "Status" },
+                { key: "amount", label: "Amount" },
+                { key: "remaining", label: "Remaining" },
+                { key: "shortfall", label: "Shortfall" },
+            ]);
         }
         catch (e) {
             handleHttp(e);
@@ -161,7 +202,7 @@ Examples:
     });
     const ordersCmd = commerceCmd
         .command("orders")
-        .description("Debug commerce orders");
+        .description("Look up commerce orders");
     ordersCmd
         .command("get")
         .description("Show a work commerce order")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "UNLICENSED",
@@ -16,7 +16,7 @@
     "@neta-art/generation": "^0.1.10",
     "commander": "^14.0.3",
     "sharp": "^0.34.5",
-    "@neta-art/cohub": "2.1.0"
+    "@neta-art/cohub": "2.2.1"
   },
   "publishConfig": {
     "access": "public"