@userland.fun/cli 0.1.1 → 0.1.3

package/dist/index.js

@@ -9,6 +9,9 @@ const KEYCHAIN_SERVICE = "fun.userland.cli";
 const KEYCHAIN_ACCOUNT = "default";
 async function main() {
     const [command, ...args] = process.argv.slice(2);
+    if (isHelpCommand(command)) {
+        usage(0);
+    }
     if (command === "apps") {
         await appsCommand(args);
         return;
@@ -965,13 +968,79 @@ function errorMessage(body) {
     const typedError = error;
     const message = typeof typedError.message === "string" ? typedError.message : undefined;
     const code = typeof typedError.code === "string" ? typedError.code : undefined;
-    if (code && message) {
-        return `${code}: ${message}`;
+    const detail = entitlementDetailMessage(typedError.details);
+    const base = code && message ? `${code}: ${message}` : message ?? code;
+    return [base, detail].filter(Boolean).join("\n");
+}
+function entitlementDetailMessage(details) {
+    if (!isPlainObject(details)) {
+        return undefined;
+    }
+    const requiredPlan = stringValue(details.required_plan_key);
+    const violations = Array.isArray(details.violations) ? details.violations.map(formatEntitlementViolation).filter(Boolean) : [];
+    const limit = stringValue(details.limit_key);
+    const allowed = details.allowed;
+    const value = details.value;
+    const lines = [];
+    if (requiredPlan) {
+        lines.push(`Required plan: ${requiredPlan}`);
+    }
+    if (violations.length > 0) {
+        lines.push("Violations:");
+        lines.push(...violations.map((violation) => `- ${violation}`));
     }
-    return message ?? code;
+    else if (limit) {
+        lines.push(`Limit: ${limit}${value !== undefined ? ` value=${String(value)}` : ""}${allowed !== undefined ? ` allowed=${formatAllowed(allowed)}` : ""}`);
+    }
+    return lines.length > 0 ? lines.join("\n") : undefined;
+}
+function formatEntitlementViolation(value) {
+    if (!isPlainObject(value)) {
+        return undefined;
+    }
+    const path = stringValue(value.manifest_path);
+    const feature = stringValue(value.feature_key);
+    const limit = stringValue(value.limit_key);
+    const requiredPlan = stringValue(value.required_plan_key);
+    const actualValue = value.value;
+    const allowed = value.allowed;
+    const parts = [
+        path,
+        feature ? `feature=${feature}` : undefined,
+        limit ? `limit=${limit}` : undefined,
+        actualValue !== undefined ? `value=${Array.isArray(actualValue) ? actualValue.join(",") : String(actualValue)}` : undefined,
+        allowed !== undefined ? `allowed=${formatAllowed(allowed)}` : undefined,
+        requiredPlan ? `requires=${requiredPlan}` : undefined
+    ].filter(Boolean);
+    return parts.length > 0 ? parts.join(" ") : undefined;
+}
+function formatAllowed(value) {
+    return Array.isArray(value) ? value.join(",") : String(value);
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function docsUrlForError(message) {
+    if (message.includes("entitlement_required") || message.includes("plan_limit_exceeded")) {
+        return "https://docs.userland.fun/reference/errors";
+    }
+    if (message.includes("USERLAND_API_KEY") || message.includes("credentials")) {
+        return "https://docs.userland.fun/reference/cli";
+    }
+    if (message.includes("secrets") || message.includes("pending_secrets")) {
+        return "https://docs.userland.fun/guides/secrets";
+    }
+    if (message.includes("rollback")) {
+        return "https://docs.userland.fun/guides/rollback";
+    }
+    return "https://docs.userland.fun/guides/troubleshooting";
+}
+function isHelpCommand(command) {
+    return command === "--help" || command === "-h" || command === "help";
 }
 function usage(exitCode) {
-    console.error(`Usage:
+    const message = `Usage:
+  userland [--help]
   userland signup [--username <username>] [--password <password>] [--email <email>] [--no-save]
   userland login [--username <username>] [--password <password>] [--no-save]
   userland auth status
@@ -998,7 +1067,13 @@ Credentials:
 
 Docs:
   https://docs.userland.fun/reference/cli
-  https://docs.userland.fun/guides/troubleshooting`);
+  https://docs.userland.fun/guides/troubleshooting`;
+    if (exitCode === 0) {
+        console.log(message);
+    }
+    else {
+        console.error(message);
+    }
     process.exit(exitCode);
 }
 main().catch((error) => {
@@ -1007,15 +1082,3 @@ main().catch((error) => {
     console.error(`Docs: ${docsUrlForError(message)}`);
     process.exit(1);
 });
-function docsUrlForError(message) {
-    if (message.includes("USERLAND_API_KEY") || message.includes("credentials")) {
-        return "https://docs.userland.fun/reference/cli";
-    }
-    if (message.includes("secrets") || message.includes("pending_secrets")) {
-        return "https://docs.userland.fun/guides/secrets";
-    }
-    if (message.includes("rollback")) {
-        return "https://docs.userland.fun/guides/rollback";
-    }
-    return "https://docs.userland.fun/guides/troubleshooting";
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@userland.fun/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Userland command-line tools for publishing and operating apps.",
   "license": "MIT",
   "type": "module",