@lessly/sdk-app 63.2.3 → 63.2.4

package/dist/_types/runtime/access-reason.d.ts

@@ -16,5 +16,12 @@ import type { Operation } from './types.js';
  * to read it from, and `level:undefined` in front of a user is worse than saying less. It is a
  * DEGRADATION, not an equal input — an App whose every gate holds an `Operation` never reaches for
  * it, and that is the normal shape, not an omission.
+ *
+ * It never throws and never renders the words `undefined` or `null`. A render helper that crashes
+ * takes a whole screen with it, so the input is checked at runtime rather than trusted from the
+ * type: an object with a usable key but no usable level degrades to the key-only sentence, and
+ * anything with no usable key at all falls back to "Not available for your role." — plus one
+ * `console.warn` outside production, because the caller has a bug worth seeing. The public type
+ * stays `Operation | string`; the widening is internal, and passing anything else is still wrong.
  */
 export declare function accessReason(op: Operation | string): string;

package/dist/index.cjs

@@ -11263,8 +11263,30 @@ function createLesslyApp(opts) {
 }
 
 // src/runtime/access-reason.ts
+var LEVELS2 = ["read", "write", "admin"];
+var isNonEmptyString = (value) => typeof value === "string" && value.trim() !== "";
+var isLevel = (value) => typeof value === "string" && LEVELS2.includes(value);
+function warnDegenerate(input) {
+  if (typeof process !== "undefined" && process.env?.NODE_ENV !== "production") {
+    console.warn("accessReason: degenerate input", input);
+  }
+}
 function accessReason(op) {
-  return typeof op === "string" ? `Requires access to ${op}. Ask an admin of this product.` : `Requires level:${op.level} (${op.operationKey}). Ask an admin of this product.`;
+  if (isNonEmptyString(op)) {
+    return `Requires access to ${op}. Ask an admin of this product.`;
+  }
+  if (op !== null && (typeof op === "object" || typeof op === "function")) {
+    const { operationKey, level } = op;
+    if (isNonEmptyString(operationKey)) {
+      if (isLevel(level)) {
+        return `Requires level:${level} (${operationKey}). Ask an admin of this product.`;
+      }
+      warnDegenerate(op);
+      return `Requires access to ${operationKey}. Ask an admin of this product.`;
+    }
+  }
+  warnDegenerate(op);
+  return "Not available for your role. Ask an admin of this product.";
 }
 
 // src/runtime/operations.ts