@lessly/sdk-app 93.0.0 → 94.1.0

package/CHANGELOG.md

@@ -29,6 +29,16 @@ are not covered here — 84.0.0 is the first version published as
 `@lepsto/sdk-app`. `@lessly/sdk-app` 86.0.0 and 87.0.0 were never mirrored to
 `@lepsto/sdk-app`, so those two numbers are absent from this package.
 
+## Unreleased (runtime minor)
+
+### Added
+
+- `isEntitlementError(err)` — true for billing's plan refusal: HTTP 402 with a
+  body `error` of `entitlement_exhausted` or `entitlement_unavailable`, the same rule the Workspace shell
+  uses to show its one refusal window. Structural, like `isAccessDenied`.
+- `upgradeUrl(err)` — the refusal's `upgrade_url` (absolute `http(s)` only),
+  for Apps the shell cannot see. Recipe: `docs/recipes/entitlements.md`.
+
 ## 87.3.1 — 2026-09-17
 
 ### Fixed
@@ -115,15 +125,9 @@ before this point lives in that package.
 The publish pipeline appends its machine-rendered block for the release being
 built below this line. It is not committed back to the repo, so in a git
 checkout this section is empty — see the note at the top.
-## 93.0.0 (major)
-
-### platform
-- removed `organization_billing_caps_clear`
-- removed `organization_billing_caps_set`
-- added `organization_billing_budget_clear`
-- added `organization_billing_budget_resume`
-- added `organization_billing_budget_set`
-- `organization_billing_budgets_get`: description updated
-- `organization_member_list`: new optional field `members.email (output)`
-- `organization_member_list`: description updated
+## 94.1.0 (minor)
+
+### *
+- runtime update
+- documentation update
 

package/dist/_types/index.d.ts

@@ -1,7 +1,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 { LesslyApiError, isAccessDenied, isEntitlementError, upgradeUrl } from './runtime/errors.js';
 export { accessReason } from './runtime/access-reason.js';
 export { platformApiBaseUrl } from './runtime/platform-base-url.js';
 export { operations } from './runtime/operations.js';

package/dist/_types/runtime/errors.d.ts

@@ -16,3 +16,16 @@ export declare function parseErrorBody(body: unknown, status: number): LesslyApi
  * report false there and an App would render a red crash for an ordinary permission refusal.
  */
 export declare function isAccessDenied(err: unknown): boolean;
+/**
+ * True iff `err` is billing refusing the call over the organization's plan (trial cap reached,
+ * a class closed on a trial, billing or budget paused). Inside the Workspace shell the shell
+ * shows the refusal itself: an App uses this to render nothing, not a second error.
+ */
+export declare function isEntitlementError(err: unknown): boolean;
+/**
+ * The refusal's `upgrade_url` — the Workspace billing page with the upgrade offer open for the
+ * refused organization — or null when `err` is not an entitlement refusal or carries no usable
+ * URL. For Apps the shell cannot see (standalone, or calling through their own `fetch`). Only an
+ * absolute http(s) URL is returned: the value is meant to be navigated to.
+ */
+export declare function upgradeUrl(err: unknown): string | null;

package/dist/index.cjs

@@ -33,6 +33,27 @@ function isAccessDenied(err) {
   const { status, code } = err;
   return status === 403 && typeof code === "string" && ACCESS_DENIED_CODES.has(code);
 }
+var ENTITLEMENT_ERRORS = /* @__PURE__ */ new Set(["entitlement_exhausted", "entitlement_unavailable"]);
+function entitlementRefusal(err) {
+  if (typeof err !== "object" || err === null) return null;
+  const { status, body } = err;
+  if (status !== 402 || typeof body !== "object" || body === null) return null;
+  const { error } = body;
+  return typeof error === "string" && ENTITLEMENT_ERRORS.has(error) ? body : null;
+}
+function isEntitlementError(err) {
+  return entitlementRefusal(err) !== null;
+}
+function upgradeUrl(err) {
+  const url = entitlementRefusal(err)?.upgrade_url;
+  if (typeof url !== "string") return null;
+  try {
+    const { protocol } = new URL(url);
+    return protocol === "https:" || protocol === "http:" ? url : null;
+  } catch {
+    return null;
+  }
+}
 
 // src/runtime/csrf.ts
 var CSRF_COOKIES = ["lepsto_csrf", "lessly_csrf"];
@@ -12740,7 +12761,9 @@ exports.compositions = compositions2;
 exports.connectStream = connectStream;
 exports.createLesslyApp = createLesslyApp;
 exports.isAccessDenied = isAccessDenied;
+exports.isEntitlementError = isEntitlementError;
 exports.operations = operations2;
 exports.platformApiBaseUrl = platformApiBaseUrl;
+exports.upgradeUrl = upgradeUrl;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map