@vex-chat/cli 0.2.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vex-chat/cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Terminal client for vex-chat.",
   "type": "module",
   "bin": {
@@ -31,7 +31,7 @@
   "dependencies": {
     "better-sqlite3": "11.10.0",
     "msgpackr": "^1.11.9",
-    "@vex-chat/libvex": "^7.1.1"
+    "@vex-chat/libvex": "^7.4.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/src/vex-chat.js

@@ -145,6 +145,9 @@ async function main() {
             case "invite":
                 await inviteCommand(ctx, positionals);
                 break;
+            case "entitlements":
+                await entitlementsCommand(ctx, positionals);
+                break;
             case "group":
                 await groupCommand(ctx, positionals);
                 break;
@@ -176,6 +179,7 @@ function isCommand(command) {
         "channels",
         "chat",
         "dm",
+        "entitlements",
         "group",
         "help",
         "invite",
@@ -285,6 +289,7 @@ async function createContext(flags) {
     return {
         dataDir,
         configPath,
+        flags,
         clientOptions: {
             dbFolder: path.join(dataDir, "db"),
             deviceName: "vex-chat-cli",
@@ -377,6 +382,11 @@ function httpFromApiUrl(raw) {
     }
 }
 
+function apiBaseUrl(ctx) {
+    const scheme = ctx.clientOptions.unsafeHttp ? "http" : "https";
+    return `${scheme}://${ctx.clientOptions.host}`;
+}
+
 function normalizeAccountHost(host) {
     return String(host ?? DEFAULT_HOST)
         .trim()
@@ -597,16 +607,68 @@ function getClientBearerToken(client) {
     return match?.[1] ?? null;
 }
 
+function responseBodyMessage(data) {
+    if (!data || typeof data !== "object" || ArrayBuffer.isView(data)) {
+        return null;
+    }
+    if (data instanceof ArrayBuffer) {
+        return null;
+    }
+    const error = data.error;
+    if (typeof error === "string") return error;
+    if (error && typeof error === "object") {
+        const nestedMessage = error.message;
+        if (typeof nestedMessage === "string") return nestedMessage;
+    }
+    const message = data.message;
+    return typeof message === "string" ? message : null;
+}
+
+function bytesFromResponseBody(data) {
+    if (ArrayBuffer.isView(data)) {
+        return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+    }
+    if (data instanceof ArrayBuffer) {
+        return new Uint8Array(data);
+    }
+    return null;
+}
+
+function decodeBinaryResponseBody(data) {
+    const bytes = bytesFromResponseBody(data);
+    if (!bytes) return null;
+    try {
+        return unpack(bytes);
+    } catch {
+        // Express JSON error bodies also arrive as ArrayBuffer with fetch.
+    }
+    const text = new TextDecoder("utf-8", { fatal: false })
+        .decode(bytes)
+        .trim();
+    if (!text) return null;
+    if (text.startsWith("{") || text.startsWith("[")) {
+        try {
+            return JSON.parse(text);
+        } catch {
+            return text;
+        }
+    }
+    return text;
+}
+
 function errorResponseMessage(err) {
     const data = err?.response?.data;
-    if (data && typeof data === "object" && !ArrayBuffer.isView(data)) {
-        const message = data.error ?? data.message;
-        if (typeof message === "string") return message;
-    }
+    const binaryBody = decodeBinaryResponseBody(data);
+    const binaryMessage = responseBodyMessage(binaryBody);
+    if (binaryMessage) return binaryMessage;
+    if (typeof binaryBody === "string") return binaryBody;
+    const objectMessage = responseBodyMessage(data);
+    if (objectMessage) return objectMessage;
     if (typeof data === "string") {
         try {
             const parsed = JSON.parse(data);
-            if (typeof parsed?.error === "string") return parsed.error;
+            const jsonMessage = responseBodyMessage(parsed);
+            if (jsonMessage) return jsonMessage;
         } catch {
             return data;
         }
@@ -1443,6 +1505,47 @@ async function inviteCommand(ctx, args) {
     });
 }
 
+async function entitlementsCommand(ctx, args) {
+    const sub = args.shift() ?? "status";
+    if (sub === "set" || sub === "grant") {
+        const userID = requireArg(args, 0, "user id");
+        const tier = requireArg(args, 1, "tier");
+        if (!["free", "plus", "pro"].includes(tier)) {
+            throw new Error("Tier must be one of: free, plus, pro.");
+        }
+        const devKey = ctx.clientOptions.devApiKey;
+        if (!devKey) {
+            throw new Error(
+                "A dev key is required. Pass --dev-key or set DEV_API_KEY.",
+            );
+        }
+        const expiresAt = ctx.flags["expires-at"]
+            ? String(ctx.flags["expires-at"])
+            : null;
+        const res = await fetch(`${apiBaseUrl(ctx)}/__dev/billing/grants`, {
+            body: JSON.stringify({ expiresAt, tier, userID }),
+            headers: {
+                "Content-Type": "application/json",
+                "x-dev-api-key": devKey,
+            },
+            method: "POST",
+        });
+        if (!res.ok) {
+            throw new Error(
+                `Entitlement grant failed with HTTP ${String(res.status)}: ${await res.text()}`,
+            );
+        }
+        const body = await res.json();
+        console.log(
+            `${color(ROOT_ACCENT, "granted")} ${color("bold", tier)} ${color("dim", `to ${userID}`)} ${color("dim", `source=${body.source ?? "unknown"}`)}`,
+        );
+        return;
+    }
+    throw new Error(
+        "Usage: vex entitlements set <user-id> <free|plus|pro> [--expires-at <iso>] --dev-key <key>",
+    );
+}
+
 async function groupCommand(ctx, args) {
     const sub = args[0];
     if (sub === "send") {
@@ -4590,6 +4693,7 @@ Commands:
   vex auth requests            list pending device login requests
   vex auth accounts
   vex auth use <username>
+  vex entitlements set <user-id> <free|plus|pro> --dev-key <key>
   vex whoami
 
 Flags: