@lessly/sdk-app 94.0.0 → 94.1.0

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"];
@@ -2013,10 +2034,6 @@ var bindings = {
           {
             "in": "body",
             "name": "media"
-          },
-          {
-            "in": "body",
-            "name": "targets"
           }
         ],
         "path": "/content/posts",
@@ -2085,10 +2102,6 @@ var bindings = {
           {
             "in": "body",
             "name": "media"
-          },
-          {
-            "in": "body",
-            "name": "targets"
           }
         ],
         "path": "/content/posts/:id",
@@ -2244,6 +2257,10 @@ var bindings = {
             "in": "body",
             "name": "channelId"
           },
+          {
+            "in": "body",
+            "name": "text"
+          },
           {
             "in": "body",
             "name": "idempotencyKey"
@@ -2299,6 +2316,10 @@ var bindings = {
             "in": "body",
             "name": "scheduledAt"
           },
+          {
+            "in": "body",
+            "name": "text"
+          },
           {
             "in": "body",
             "name": "idempotencyKey"
@@ -6154,47 +6175,48 @@ var bindings = {
         "readOnly": true
       }
     },
-    "billing-budgets": {
-      "get": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "organization_billing_budgets_get",
-        "path": "/governance/api/v1/billing/budgets",
-        "readOnly": true
-      }
-    },
-    "billing-caps": {
+    "billing-budget": {
       "clear": {
         "level": "write",
         "method": "DELETE",
-        "operationKey": "organization_billing_caps_clear",
-        "params": [
-          {
-            "in": "body",
-            "name": "productId"
-          }
-        ],
-        "path": "/governance/api/v1/billing/budgets/cap",
+        "operationKey": "organization_billing_budget_clear",
+        "path": "/governance/api/v1/billing/budgets",
+        "readOnly": false
+      },
+      "resume": {
+        "level": "write",
+        "method": "POST",
+        "operationKey": "organization_billing_budget_resume",
+        "path": "/governance/api/v1/billing/budgets/resume",
         "readOnly": false
       },
       "set": {
         "level": "write",
         "method": "PUT",
-        "operationKey": "organization_billing_caps_set",
+        "operationKey": "organization_billing_budget_set",
         "params": [
           {
             "in": "body",
-            "name": "productId"
+            "name": "amount_minor"
           },
           {
             "in": "body",
-            "name": "cap_minor"
+            "name": "action"
           }
         ],
-        "path": "/governance/api/v1/billing/budgets/cap",
+        "path": "/governance/api/v1/billing/budgets",
         "readOnly": false
       }
     },
+    "billing-budgets": {
+      "get": {
+        "level": "read",
+        "method": "GET",
+        "operationKey": "organization_billing_budgets_get",
+        "path": "/governance/api/v1/billing/budgets",
+        "readOnly": true
+      }
+    },
     "bindings": {
       "list": {
         "level": "read",
@@ -7621,213 +7643,6 @@ var bindings = {
       }
     }
   },
-  "playground": {
-    "analytics": {
-      "overview": {
-        "level": "read",
-        "method": "POST",
-        "operationKey": "playground_analytics_overview",
-        "params": [
-          {
-            "in": "body",
-            "name": "limit"
-          }
-        ],
-        "path": "/playground/analytics/overview",
-        "readOnly": true
-      }
-    },
-    "billing": {
-      "entitlements": {
-        "level": "read",
-        "method": "POST",
-        "operationKey": "playground_billing_entitlements",
-        "path": "/playground/billing/entitlements",
-        "readOnly": true
-      },
-      "record-usage": {
-        "level": "write",
-        "method": "POST",
-        "operationKey": "playground_billing_record-usage",
-        "params": [
-          {
-            "in": "body",
-            "name": "value"
-          }
-        ],
-        "path": "/playground/billing/usage",
-        "readOnly": false
-      }
-    },
-    "clickup": {
-      "create-task": {
-        "level": "write",
-        "method": "POST",
-        "operationKey": "playground_clickup_create-task",
-        "params": [
-          {
-            "in": "body",
-            "name": "listId"
-          },
-          {
-            "in": "body",
-            "name": "name"
-          }
-        ],
-        "path": "/playground/clickup/tasks",
-        "readOnly": false
-      },
-      "get-last-webhook": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "playground_clickup_get-last-webhook",
-        "path": "/playground/clickup/webhooks/last",
-        "readOnly": true
-      },
-      "get-overview": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "playground_clickup_get-overview",
-        "path": "/playground/clickup/overview",
-        "readOnly": true
-      }
-    },
-    "echo": {
-      "ping": {
-        "level": "read",
-        "method": "POST",
-        "operationKey": "playground_echo_ping",
-        "params": [
-          {
-            "in": "body",
-            "name": "message"
-          }
-        ],
-        "path": "/playground/echo/ping",
-        "readOnly": true
-      }
-    },
-    "gdrive": {
-      "get-last-change": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "playground_gdrive_get-last-change",
-        "path": "/playground/gdrive/changes/last",
-        "readOnly": true
-      },
-      "read-file": {
-        "level": "read",
-        "method": "POST",
-        "operationKey": "playground_gdrive_read-file",
-        "params": [
-          {
-            "in": "body",
-            "name": "fileId"
-          }
-        ],
-        "path": "/playground/gdrive/file",
-        "readOnly": true
-      }
-    },
-    "googleads": {
-      "read-customer": {
-        "level": "read",
-        "method": "POST",
-        "operationKey": "playground_googleads_read-customer",
-        "path": "/playground/googleads/customer",
-        "readOnly": true
-      }
-    },
-    "lifecycle": {
-      "get-state": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "playground_lifecycle_get-state",
-        "path": "/playground/lifecycle/state",
-        "readOnly": true
-      },
-      "list-events": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "playground_lifecycle_list-events",
-        "path": "/playground/lifecycle/events",
-        "readOnly": true
-      }
-    },
-    "webhook": {
-      "get-last": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "playground_webhook_get-last",
-        "path": "/playground/webhooks/last",
-        "readOnly": true
-      }
-    },
-    "workflow": {
-      "echo": {
-        "level": "write",
-        "method": "POST",
-        "operationKey": "playground_workflow_echo",
-        "params": [
-          {
-            "in": "body",
-            "name": "note"
-          },
-          {
-            "in": "body",
-            "name": "tags"
-          }
-        ],
-        "path": "/playground/workflow/echo",
-        "readOnly": false
-      },
-      "echo-list": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "playground_workflow_echo-list",
-        "path": "/playground/workflow/echoes",
-        "readOnly": true
-      },
-      "ping": {
-        "level": "write",
-        "method": "POST",
-        "operationKey": "playground_workflow_ping",
-        "params": [
-          {
-            "in": "body",
-            "name": "kind"
-          }
-        ],
-        "path": "/playground/workflow/ping",
-        "readOnly": false
-      },
-      "subjects-list": {
-        "level": "read",
-        "method": "GET",
-        "operationKey": "playground_workflow_subjects-list",
-        "params": [
-          {
-            "in": "query",
-            "name": "last_activity_before"
-          },
-          {
-            "in": "query",
-            "name": "last_activity_after"
-          },
-          {
-            "in": "query",
-            "name": "limit"
-          },
-          {
-            "in": "query",
-            "name": "cursor"
-          }
-        ],
-        "path": "/playground/workflow/subjects",
-        "readOnly": true
-      }
-    }
-  },
   "realtime": {
     "archive": {
       "export": {
@@ -12211,9 +12026,10 @@ var operations = {
   "observe_webhooks_rotate_secret": "admin",
   "observe_webhooks_update": "write",
   "organization_auth_me": "read",
+  "organization_billing_budget_clear": "write",
+  "organization_billing_budget_resume": "write",
+  "organization_billing_budget_set": "write",
   "organization_billing_budgets_get": "read",
-  "organization_billing_caps_clear": "write",
-  "organization_billing_caps_set": "write",
   "organization_bindings_list": "read",
   "organization_clickup_install": "read",
   "organization_clickup_list-installations": "read",
@@ -12300,23 +12116,6 @@ var operations = {
   "organization_support_threads_list": "read",
   "organization_x_install": "read",
   "organization_youtube_install": "read",
-  "playground_analytics_overview": "read",
-  "playground_billing_entitlements": "read",
-  "playground_billing_record-usage": "write",
-  "playground_clickup_create-task": "write",
-  "playground_clickup_get-last-webhook": "read",
-  "playground_clickup_get-overview": "read",
-  "playground_echo_ping": "read",
-  "playground_gdrive_get-last-change": "read",
-  "playground_gdrive_read-file": "read",
-  "playground_googleads_read-customer": "read",
-  "playground_lifecycle_get-state": "read",
-  "playground_lifecycle_list-events": "read",
-  "playground_webhook_get-last": "read",
-  "playground_workflow_echo": "write",
-  "playground_workflow_echo-list": "read",
-  "playground_workflow_ping": "write",
-  "playground_workflow_subjects-list": "read",
   "realtime_archive_export": "admin",
   "realtime_archive_export_status": "read",
   "realtime_archive_get": "read",
@@ -12546,10 +12345,10 @@ var compositions = {
   "brain_memory_update": { "pii": ["input.content"], "label": "Update memory", "options": { "memory_id": "brain_memory_list" } },
   "brain_usage_report": { "label": "Get usage report" },
   "content_metrics_post_series": { "label": "Read post metrics", "options": { "id": "content_publications_list" } },
-  "content_posts_create": { "pii": ["output.author", "output.text", "output.media", "output.targets"], "label": "Create draft post" },
-  "content_posts_get": { "pii": ["output.author", "output.text", "output.media", "output.targets"], "label": "Get post", "options": { "id": "content_posts_list" } },
-  "content_posts_list": { "pii": ["output.posts[].author", "output.posts[].text", "output.posts[].media", "output.posts[].targets"], "label": "List posts" },
-  "content_posts_submit": { "pii": ["output.author", "output.text", "output.media", "output.targets"], "label": "Submit post for approval", "options": { "id": "content_posts_list" } },
+  "content_posts_create": { "pii": ["output.author", "output.text", "output.media"], "label": "Create draft post" },
+  "content_posts_get": { "pii": ["output.author", "output.text", "output.media"], "label": "Get post", "options": { "id": "content_posts_list" } },
+  "content_posts_list": { "pii": ["output.posts[].author", "output.posts[].text", "output.posts[].media"], "label": "List posts" },
+  "content_posts_submit": { "pii": ["output.author", "output.text", "output.media"], "label": "Submit post for approval", "options": { "id": "content_posts_list" } },
   "content_publications_cancel": { "label": "Cancel publication", "options": { "id": "content_publications_list" } },
   "content_publications_publish": { "label": "Publish now", "options": { "postId": "content_posts_list", "channelId": "content_channels_list" }, "completion_event": "content/publication.settled" },
   "content_publications_schedule": { "label": "Schedule publication", "options": { "postId": "content_posts_list", "channelId": "content_channels_list" }, "completion_event": "content/publication.settled" },
@@ -12599,9 +12398,6 @@ var compositions = {
   "mail_template_unarchive": { "label": "Unarchive template", "options": { "id": "mail_template_list" } },
   "mail_template_update": { "label": "Update template", "options": { "id": "mail_template_list" } },
   "mail_usage_get": { "label": "Get usage" },
-  "playground_workflow_echo": { "pii": ["input.note", "output.note"], "label": "Store workflow echo", "completion_event": "playground/workflow.echoed" },
-  "playground_workflow_ping": { "label": "Fire workflow ping", "completion_event": "playground/workflow.ping" },
-  "playground_workflow_subjects-list": { "pii": ["output.items[].display_name"], "label": "List workflow subjects" },
   "support_agent_create": { "pii": ["input.lesslyUserId", "output.lesslyUserId"], "label": "Create agent" },
   "support_agent_get": { "pii": ["output.lesslyUserId"], "label": "Get agent", "options": { "id": "support_agent_list" } },
   "support_agent_list": { "pii": ["output.agents[].lesslyUserId"], "label": "List agents" },
@@ -12965,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