@userland.fun/cli 0.1.2 → 0.1.3

package/dist/index.js

@@ -968,10 +968,72 @@ 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}`));
+    }
+    else if (limit) {
+        lines.push(`Limit: ${limit}${value !== undefined ? ` value=${String(value)}` : ""}${allowed !== undefined ? ` allowed=${formatAllowed(allowed)}` : ""}`);
     }
-    return message ?? code;
+    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";
@@ -1020,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.2",
+  "version": "0.1.3",
   "description": "Userland command-line tools for publishing and operating apps.",
   "license": "MIT",
   "type": "module",