@lessly/sdk-app 97.3.0 → 97.4.0

package/docs/recipes/access.md

@@ -615,11 +615,19 @@ function DomainList({ app }: { app: App }) {
 ```
 
 Put that branch in your shared query-state component once, rather than in every
-screen. `isAccessDenied` is true for exactly the three gateway codes that mean
-*the caller's access was the reason* — `role_denied`,
-`operation_uncatalogued`, `no_tool_permission` — and false for every other 403.
-A `tenant_blocked` 403 is not a permission problem and must not be rendered as
-one: it sends the user to an admin who can do nothing about it.
+screen. `isAccessDenied` is true for exactly three gateway 403 codes:
+`role_denied` and `no_tool_permission` are permission decisions, while
+`operation_uncatalogued` means the operation is missing from the catalog or
+still rolling out. The user cannot fix that catalog state by asking for a grant.
+All three get the same neutral user-facing state; other 403s do not. A
+`tenant_blocked` 403, for example, is not a permission problem and must not be
+rendered as one.
+
+Use `accessDenialKind(error)` when telemetry or a developer-only hint needs to
+distinguish the catalog case. It returns one of those three codes for a matching
+403, or `null` for anything else. An `operation_uncatalogued` hint can tell a
+developer to re-register the toolkit; never choose different user-facing denial
+copy from the kind.
 
 **Never render an access denial in red.** A permission boundary is expected,
 frequent and not the user's mistake. Painting it as a crash teaches people to

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lessly/sdk-app",
   "description": "The Lessly SDK for App is a TypeScript SDK that provides runtime bindings and type-safe generated code for interacting with Lessly Platform APIs and services. This package generates type definitions and client bindings from API catalogs, enabling developers to build applications that consume Lessly platform services with full type safety and autocompletion.",
-  "version": "97.3.0",
+  "version": "97.4.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lepsto/lepsto-sdk-app.git"