@lessly/sdk-app 62.0.0 → 62.1.0

package/dist/_types/index.d.ts

@@ -2,6 +2,7 @@ export { createLesslyApp } from './runtime/createLesslyApp.js';
 export type { LesslyClientBase } from './runtime/createLesslyApp.js';
 export { connectStream } from './runtime/connectStream.js';
 export { LesslyApiError, isAccessDenied } from './runtime/errors.js';
+export { accessReason } from './runtime/access-reason.js';
 export type { LesslyAppOptions, HttpMethod, Binding, BindingsMap, ParamSpec, ParamIn, ToolLevel, Operation, } from './runtime/types.js';
 export type { WsBinding, WsBindingsMap, LesslyStream, LesslyStreamOpener, StreamCloseInfo, StreamData, WebSocketCtor, WebSocketLike, } from './runtime/types.js';
 export type { Access, AccessState, AccessApi } from './runtime/access.js';

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

@@ -0,0 +1,20 @@
+import type { Operation } from './types.js';
+/**
+ * The one reason string every App shows on a gated control (APP-012).
+ *
+ * Both values come from the generated method, so the sentence cannot drift when the catalog
+ * re-levels a tool. It names the operation key as well as the level because a level alone does not
+ * identify a grant — a screenful of controls can all require `write` — and an admin grants by
+ * level AND by exact key, so the user has to be able to pass on both.
+ *
+ * It explains ONE operation. Picking which one — the first that `can()` denied, among the several
+ * a button performs — is the caller's job: the rule differs between a button that runs every
+ * operation and one that dispatches to a single one, so this takes no array.
+ *
+ * A bare key is the fallback for a control with no generated method to point at (a runtime probe,
+ * an operation no method covers). It drops the level rather than inventing one: there is nothing
+ * 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.
+ */
+export declare function accessReason(op: Operation | string): string;

package/dist/index.cjs

@@ -11402,7 +11402,13 @@ function createLesslyApp(opts) {
   });
 }
 
+// src/runtime/access-reason.ts
+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.`;
+}
+
 exports.LesslyApiError = LesslyApiError;
+exports.accessReason = accessReason;
 exports.connectStream = connectStream;
 exports.createLesslyApp = createLesslyApp;
 exports.isAccessDenied = isAccessDenied;