@neta-art/cohub-cli 2.0.0 → 2.2.0

package/dist/commands/run.js

@@ -14,7 +14,7 @@ function shellJoin(values) {
 }
 function topLevelRunIndex(argv) {
     for (let index = 0; index < argv.length; index += 1) {
-        const token = argv[index];
+        const token = argv[index] ?? "";
         if (token === "--")
             return -1;
         if (token === "-s" || token === "--space") {
@@ -31,7 +31,7 @@ function topLevelRunIndex(argv) {
 }
 function parseSpaceId(tokens) {
     for (let index = 0; index < tokens.length; index += 1) {
-        const token = tokens[index];
+        const token = tokens[index] ?? "";
         if (token === "-s" || token === "--space") {
             const value = tokens[index + 1];
             if (!value)
@@ -55,7 +55,7 @@ function parseRunCliOptions(argv) {
     let commandOption = null;
     let positionalTokens = [];
     for (let index = 0; index < afterRun.length; index += 1) {
-        const token = afterRun[index];
+        const token = afterRun[index] ?? "";
         if (token === "-h" || token === "--help") {
             printRunHelp();
             process.exit(0);

package/dist/commands/space-commerce.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerSpaceCommerce(spacesCmd: Command): void;

package/dist/commands/space-commerce.js

@@ -0,0 +1,500 @@
+import { createClient } from "../client.js";
+import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
+import { resolveSpace } from "../space.js";
+const PRODUCT_STATUSES = ["draft", "active"];
+const PRODUCT_UPDATE_STATUSES = ["draft", "active", "archived"];
+const PRODUCT_VISIBILITIES = ["public", "private"];
+const BENEFIT_STATUSES = ["active", "archived"];
+function requireText(value, label, flag) {
+    const text = value?.trim();
+    if (text)
+        return text;
+    return error(`Missing ${label}`, `Pass ${flag}.`);
+}
+function parseChoice(value, label, choices) {
+    if (value === undefined)
+        return undefined;
+    if (choices.includes(value))
+        return value;
+    return error(`Invalid ${label}`, `Use one of: ${choices.join(", ")}.`);
+}
+function parseInteger(value, label, options) {
+    if (value === undefined)
+        return options.fallback;
+    if (!/^-?\d+$/.test(value.trim()))
+        return error(`Invalid ${label}`, `${label} must be an integer.`);
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isSafeInteger(parsed))
+        return error(`Invalid ${label}`, `${label} must be a safe integer.`);
+    if (options.min !== undefined && parsed < options.min)
+        return error(`Invalid ${label}`, `${label} must be at least ${options.min}.`);
+    if (options.max !== undefined && parsed > options.max)
+        return error(`Invalid ${label}`, `${label} must be at most ${options.max}.`);
+    return parsed;
+}
+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.");
+    }
+    const amount = Number(text);
+    if (!Number.isFinite(amount))
+        return error("Invalid amount", "--amount-usd must be a finite USD amount.");
+    return amount;
+}
+function parseMetadataJson(value) {
+    if (value === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return error("Invalid metadata", "--metadata-json must be a JSON object.");
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return error("Invalid metadata", "--metadata-json must be a JSON object.");
+    }
+    const metadata = {};
+    for (const [key, item] of Object.entries(parsed)) {
+        if (typeof item !== "string" && typeof item !== "number" && typeof item !== "boolean") {
+            return error("Invalid metadata", `Metadata value for "${key}" must be string, number, or boolean.`);
+        }
+        if (typeof item === "number" && !Number.isFinite(item)) {
+            return error("Invalid metadata", `Metadata value for "${key}" must be a finite number.`);
+        }
+        metadata[key] = item;
+    }
+    return metadata;
+}
+function compact(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
+}
+function formatUsd(amount) {
+    return `$${amount.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+}
+function formatMinorUsd(amountMinor) {
+    return formatUsd(amountMinor / 100);
+}
+function printProducts(products) {
+    table(products.map((product) => ({
+        key: product.key,
+        name: product.name,
+        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) => {
+        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: "detail", label: "Detail" },
+    ]);
+}
+function printOrders(orders) {
+    table(orders.map((order) => ({
+        id: order.id,
+        product: order.productKeySnapshot,
+        status: order.status,
+        amount: formatMinorUsd(order.amountSnapshot),
+        created: order.createdAt,
+    })), [
+        { key: "id", label: "ID" },
+        { key: "product", label: "Product" },
+        { key: "status", label: "Status" },
+        { key: "amount", label: "Amount" },
+        { key: "created", label: "Created" },
+    ]);
+}
+async function confirmDanger(opts, detail) {
+    if (opts.yes)
+        return;
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        return error("Confirmation required", `Pass --yes to ${detail}.`);
+    process.stdout.write(`${detail[0]?.toUpperCase() ?? "C"}${detail.slice(1)}? [y/N] `);
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+        break;
+    }
+    const answer = Buffer.concat(chunks).toString().trim().toLowerCase();
+    if (answer !== "y" && answer !== "yes")
+        return error("Cancelled");
+}
+function commerceClient(spacesCmd) {
+    const spaceId = resolveSpace(spacesCmd);
+    return { spaceId, commerce: createClient().space(spaceId).commerce };
+}
+export function registerSpaceCommerce(spacesCmd) {
+    const commerceCmd = spacesCmd
+        .command("commerce")
+        .description("Manage space commerce")
+        .addHelpText("after", `
+Examples:
+  cohub -s <space-id> spaces commerce setup
+  cohub -s <space-id> spaces commerce products list
+  COHUB_SPACE_ID=<space-id> cohub spaces commerce orders list --limit 10
+`);
+    commerceCmd
+        .command("setup")
+        .description("Initialize commerce for the target space")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.setup();
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Commerce initialized: ${result.businessKey}`);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    const productsCmd = commerceCmd
+        .command("products")
+        .description("Manage products")
+        .addHelpText("after", `
+Examples:
+  cohub -s <space-id> spaces commerce products list
+  cohub -s <space-id> spaces commerce products create --name "Pro Pack" --amount-usd 9.99
+`);
+    productsCmd
+        .command("list")
+        .description("List products")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.listProducts();
+            if (jsonRequested(opts))
+                return outJson(result);
+            printProducts(result.products);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    productsCmd
+        .command("create")
+        .description("Create a product")
+        .option("--product-key <key>", "Product key override")
+        .option("--name <name>", "Product name")
+        .option("--amount-usd <amount>", "One-time price in USD")
+        .option("--description <text>", "Product description")
+        .option("--status <status>", "Product status: draft, active")
+        .option("--visibility <visibility>", "Product visibility: public, private")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const input = {
+            key: opts.productKey?.trim() || undefined,
+            name: requireText(opts.name, "name", "--name <name>"),
+            description: opts.description,
+            amountUsd: parseAmountUsd(opts.amountUsd),
+            status: parseChoice(opts.status, "status", PRODUCT_STATUSES),
+            visibility: parseChoice(opts.visibility, "visibility", PRODUCT_VISIBILITIES),
+        };
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.createProduct(input);
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Product created: ${result.product.key}`);
+            printProducts([result.product]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    productsCmd
+        .command("update")
+        .description("Update a product")
+        .option("--product-key <key>", "Product key")
+        .option("--name <name>", "Product name")
+        .option("--description <text>", "Product description")
+        .option("--clear-description", "Clear the product description")
+        .option("--status <status>", "Product status: draft, active, archived")
+        .option("--visibility <visibility>", "Product visibility: public, private")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        if (opts.description !== undefined && opts.clearDescription)
+            return error("Conflicting description", "Use either --description or --clear-description.");
+        const productKey = requireText(opts.productKey, "product key", "--product-key <key>");
+        const input = compact({
+            name: opts.name,
+            description: opts.clearDescription ? null : opts.description,
+            status: parseChoice(opts.status, "status", PRODUCT_UPDATE_STATUSES),
+            visibility: parseChoice(opts.visibility, "visibility", PRODUCT_VISIBILITIES),
+        });
+        if (Object.keys(input).length === 0)
+            return error("Nothing to update", "Pass --name, --description, --clear-description, --status, or --visibility.");
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.updateProduct(productKey, input);
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Product updated: ${result.product.key}`);
+            printProducts([result.product]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    productsCmd
+        .command("archive")
+        .description("Archive a product")
+        .option("--product-key <key>", "Product key")
+        .option("-y, --yes", "Confirm archive")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const productKey = requireText(opts.productKey, "product key", "--product-key <key>");
+        await confirmDanger(opts, `archive product "${productKey}"`);
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.updateProduct(productKey, { status: "archived" });
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Product archived: ${result.product.key}`);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    const benefitsCmd = commerceCmd
+        .command("benefits")
+        .description("Manage benefits")
+        .addHelpText("after", `
+Examples:
+  cohub -s <space-id> spaces commerce benefits list
+  cohub -s <space-id> spaces commerce benefits create --name "Premium Export" --metadata-json '{"limit":100}'
+`);
+    benefitsCmd
+        .command("list")
+        .description("List benefits")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.listBenefits();
+            if (jsonRequested(opts))
+                return outJson(result);
+            printBenefits(result.benefits);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    benefitsCmd
+        .command("create")
+        .description("Create a benefit")
+        .option("--benefit-key <key>", "Benefit key override")
+        .option("--name <name>", "Benefit name")
+        .option("--description <text>", "Benefit description")
+        .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,
+            description: opts.description,
+            type: "feature",
+            metadata: parseMetadataJson(opts.metadataJson),
+        };
+        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);
+        }
+    });
+    benefitsCmd
+        .command("update")
+        .description("Update a benefit")
+        .option("--benefit-key <key>", "Benefit key")
+        .option("--name <name>", "Benefit name")
+        .option("--description <text>", "Benefit description")
+        .option("--clear-description", "Clear the benefit description")
+        .option("--status <status>", "Benefit status: active, archived")
+        .option("--metadata-json <json>", "Replace metadata with a JSON object")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        if (opts.description !== undefined && opts.clearDescription)
+            return error("Conflicting description", "Use either --description or --clear-description.");
+        const benefitKey = requireText(opts.benefitKey, "benefit key", "--benefit-key <key>");
+        const input = compact({
+            name: opts.name,
+            description: opts.clearDescription ? null : opts.description,
+            status: parseChoice(opts.status, "status", BENEFIT_STATUSES),
+            metadata: parseMetadataJson(opts.metadataJson),
+        });
+        if (Object.keys(input).length === 0)
+            return error("Nothing to update", "Pass --name, --description, --clear-description, --status, or --metadata-json.");
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.updateBenefit(benefitKey, input);
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Benefit updated: ${result.benefit.key}`);
+            printBenefits([result.benefit]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    benefitsCmd
+        .command("archive")
+        .description("Archive a benefit")
+        .option("--benefit-key <key>", "Benefit key")
+        .option("-y, --yes", "Confirm archive")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const benefitKey = requireText(opts.benefitKey, "benefit key", "--benefit-key <key>");
+        await confirmDanger(opts, `archive benefit "${benefitKey}"`);
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.updateBenefit(benefitKey, { status: "archived" });
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Benefit archived: ${result.benefit.key}`);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    commerceCmd
+        .command("bind")
+        .description("Bind a benefit to a product")
+        .option("--product-key <key>", "Product key")
+        .option("--benefit-key <key>", "Benefit key")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const input = {
+            productKey: requireText(opts.productKey, "product key", "--product-key <key>"),
+            benefitKey: requireText(opts.benefitKey, "benefit key", "--benefit-key <key>"),
+        };
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.bindProductBenefit(input);
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Benefit bound: ${input.benefitKey} -> ${input.productKey}`);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    commerceCmd
+        .command("unbind")
+        .description("Unbind a benefit from a product")
+        .option("--product-key <key>", "Product key")
+        .option("--benefit-key <key>", "Benefit key")
+        .option("-y, --yes", "Confirm unbind")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const input = {
+            productKey: requireText(opts.productKey, "product key", "--product-key <key>"),
+            benefitKey: requireText(opts.benefitKey, "benefit key", "--benefit-key <key>"),
+        };
+        await confirmDanger(opts, `unbind benefit "${input.benefitKey}" from product "${input.productKey}"`);
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.unbindProductBenefit(input);
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Benefit unbound: ${input.benefitKey} -> ${input.productKey}`);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    const ordersCmd = commerceCmd
+        .command("orders")
+        .description("Manage orders");
+    ordersCmd
+        .command("list")
+        .description("List recent orders")
+        .option("--page <page>", "Page number")
+        .option("--limit <limit>", "Page size, max 50")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const { commerce } = commerceClient(spacesCmd);
+        try {
+            const result = await commerce.listOrders({
+                page: parseInteger(opts.page, "page", { fallback: 1, min: 1 }),
+                limit: parseInteger(opts.limit, "limit", { fallback: 20, min: 1, max: 50 }),
+            });
+            if (jsonRequested(opts))
+                return outJson(result);
+            printOrders(result.orders);
+            if (result.pagination.hasMore)
+                console.log(`\nNext page: ${result.pagination.nextPage}`);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+}

package/dist/commands/spaces.js

@@ -7,6 +7,7 @@ import { uploadAvatarAsset, uploadChatImageAsset } from "../avatar.js";
 import { createClient } from "../client.js";
 import { table, json as outJson, jsonRequested, ok, error, handleHttp } from "../output.js";
 import { resolveSpace } from "../space.js";
+import { registerSpaceCommerce } from "./space-commerce.js";
 const cliEnv = resolveCohubEnvironment();
 const defaultIdleTtlSeconds = cliEnv === "prod" ? 12 * 60 * 60 : 10 * 60;
 const SPACE_ROLES = ["host", "builder", "guest"];
@@ -478,6 +479,8 @@ export function registerSpaces(program) {
     registerMods(spacesCmd);
     // ── spaces labels ──
     registerLabels(spacesCmd);
+    // ── spaces commerce ──
+    registerSpaceCommerce(spacesCmd);
     // ── spaces usage ──
     spacesCmd
         .command("usage [days]")

package/dist/commands/work-commerce.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerWorkCommerce(worksCmd: Command): void;

package/dist/commands/work-commerce.js

@@ -0,0 +1,226 @@
+import { createClient } from "../client.js";
+import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
+function collectOption(value, previous = []) {
+    return [...previous, value];
+}
+function requireText(value, label, flag) {
+    const text = value?.trim();
+    if (text)
+        return text;
+    return error(`Missing ${label}`, `Pass ${flag}.`);
+}
+function requireList(values, label, flag) {
+    const items = [...new Set((values ?? []).map((value) => value.trim()).filter(Boolean))];
+    if (items.length > 0)
+        return items;
+    return error(`Missing ${label}`, `Pass ${flag}.`);
+}
+function formatUsd(amount) {
+    return `$${amount.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+}
+function formatMinorUsd(amountMinor) {
+    return formatUsd(amountMinor / 100);
+}
+function printProducts(products) {
+    table(products.map((product) => ({
+        key: product.key,
+        name: product.name,
+        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(result) {
+    table(result.entitlements.map((item) => ({
+        benefitKey: item.benefitKey,
+        enabled: item.enabled ? "yes" : "no",
+        metadata: item.metadata ? JSON.stringify(item.metadata) : "",
+    })), [
+        { key: "benefitKey", label: "Benefit" },
+        { key: "enabled", label: "Enabled" },
+        { key: "metadata", label: "Metadata" },
+    ]);
+    console.log(`\nCredits available: ${result.credits.available} (net: ${result.credits.net})`);
+}
+function printOrder(order) {
+    table([{
+            id: order.id,
+            product: order.productKeySnapshot,
+            status: order.status,
+            amount: formatMinorUsd(order.amountSnapshot),
+            paid: formatMinorUsd(order.paidAmountSnapshot),
+            created: order.createdAt,
+            paidAt: order.paidAt ?? "",
+        }], [
+        { key: "id", label: "ID" },
+        { key: "product", label: "Product" },
+        { key: "status", label: "Status" },
+        { key: "amount", label: "Amount" },
+        { key: "paid", label: "Paid" },
+        { key: "created", label: "Created" },
+        { key: "paidAt", label: "Paid At" },
+    ]);
+}
+export function registerWorkCommerce(worksCmd) {
+    const commerceCmd = worksCmd
+        .command("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 --work-id <work-id>
+  cohub works commerce credits consume --work-id <work-id> --amount 100
+`);
+    const productsCmd = commerceCmd
+        .command("products")
+        .description("Resolve commerce products");
+    productsCmd
+        .command("resolve")
+        .description("Resolve public products for a work")
+        .option("--work-id <id>", "Work ID")
+        .option("--product-key <key>", "Product key", collectOption)
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const workId = requireText(opts.workId, "work ID", "--work-id <id>");
+        const productKeys = requireList(opts.productKey, "product key", "--product-key <key>");
+        const client = createClient();
+        try {
+            const result = await client.workCommerce.resolveProducts(workId, { productKeys });
+            if (jsonRequested(opts))
+                return outJson(result);
+            printProducts(result.products);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    commerceCmd
+        .command("entitlements")
+        .description("Show viewer entitlements and credit balance for a work")
+        .option("--work-id <id>", "Work ID")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const workId = requireText(opts.workId, "work ID", "--work-id <id>");
+        const client = createClient();
+        try {
+            const result = await client.workCommerce.getEntitlements(workId);
+            if (jsonRequested(opts))
+                return outJson(result);
+            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);
+        }
+    });
+    commerceCmd
+        .command("purchase")
+        .description("Create a work purchase checkout")
+        .option("--work-id <id>", "Work ID")
+        .option("--product-key <key>", "Product key")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const workId = requireText(opts.workId, "work ID", "--work-id <id>");
+        const productKey = requireText(opts.productKey, "product key", "--product-key <key>");
+        const client = createClient();
+        try {
+            const result = await client.workCommerce.purchase(workId, { productKey });
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Checkout created: ${result.checkout.orderId}`);
+            table([{
+                    orderId: result.checkout.orderId,
+                    productKey: result.checkout.productKey,
+                    usable: result.checkout.checkoutUsable ? "yes" : "no",
+                    status: result.checkout.status ?? "",
+                    checkoutUrl: result.checkout.checkoutUrl ?? "",
+                    message: result.checkout.message ?? "",
+                }], [
+                { key: "orderId", label: "Order" },
+                { key: "productKey", label: "Product" },
+                { key: "usable", label: "Usable" },
+                { key: "status", label: "Status" },
+                { key: "checkoutUrl", label: "Checkout URL" },
+                { key: "message", label: "Message" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    const ordersCmd = commerceCmd
+        .command("orders")
+        .description("Look up commerce orders");
+    ordersCmd
+        .command("get")
+        .description("Show a work commerce order")
+        .option("--work-id <id>", "Work ID")
+        .option("--order-id <id>", "Order ID")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const workId = requireText(opts.workId, "work ID", "--work-id <id>");
+        const orderId = requireText(opts.orderId, "order ID", "--order-id <id>");
+        const client = createClient();
+        try {
+            const result = await client.workCommerce.getOrder(workId, orderId);
+            if (jsonRequested(opts))
+                return outJson(result);
+            printOrder(result.order);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+}

package/dist/commands/works.js

@@ -2,6 +2,7 @@ import { HttpError } from "@neta-art/cohub";
 import { createClient } from "../client.js";
 import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
 import { resolveSpace } from "../space.js";
+import { registerWorkCommerce } from "./work-commerce.js";
 const WORK_STATUSES = ["published", "disabled"];
 const WORK_VISIBILITIES = ["public", "space"];
 const collectOption = (value, previous = []) => [...previous, value];
@@ -363,6 +364,7 @@ export function registerWorks(program) {
             handleHttp(e);
         }
     });
+    registerWorkCommerce(worksCmd);
     worksCmd
         .command("rm <id>")
         .alias("delete")

package/dist/index.js

@@ -44,6 +44,7 @@ Common commands:
   cohub -s <space-id> spaces sessions turns ls <session-id>
   cohub -s <space-id> spaces files ls
   cohub -s <space-id> works publish demo --file dist/index.html
+  cohub -s <space-id> spaces commerce products list
   cohub models ls
   cohub models ls --model-type multimodal
   cohub generate "A calm lake at sunrise" --model <model> --output lake.png

package/dist/output.js

@@ -85,15 +85,28 @@ function fetchFailureDetail(e) {
         ? `Network request failed (${parts.join(" · ")}). Check DNS/proxy/firewall settings and try again.`
         : "Network request failed. Check DNS/proxy/firewall settings and try again.";
 }
+function errorPresentationFromHttpError(e) {
+    const httpError = e;
+    if (httpError.code === "space_commerce_not_initialized") {
+        return {
+            message: "space commerce is not initialized",
+            detail: "run `cohub -s <space-id> spaces commerce setup` first",
+        };
+    }
+    return null;
+}
 export function handleHttp(e) {
     if (e instanceof Error && e.name === "AuthRequiredError") {
         return error("not authenticated", "run `cohub auth login`");
     }
     const status = e.status;
     const body = e.body;
-    const message = errorMessageFromBody(body) ?? (e instanceof Error ? e.message : String(e));
+    const presentation = errorPresentationFromHttpError(e);
+    const message = presentation?.message ?? errorMessageFromBody(body) ?? (e instanceof Error ? e.message : String(e));
     const fetchDetail = fetchFailureDetail(e);
     const detailParts = [];
+    if (presentation?.detail)
+        detailParts.push(presentation.detail);
     if (process.env.COHUB_DEBUG_ERRORS) {
         if (status)
             detailParts.push(`HTTP ${status}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "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.0.0"
+    "@neta-art/cohub": "2.2.0"
   },
   "publishConfig": {
     "access": "public"