@lessly/sdk-app 63.2.2 → 63.2.4

package/docs/recipes/access.md

@@ -190,7 +190,11 @@ accessReason(app.mail.domain.create);
 ```
 
 Use it in every example below; nothing in an App should assemble this text by
-hand.
+hand. It never throws and never renders the word `undefined`: an object with a
+key but no usable level degrades to the key-only sentence, and an input with no
+usable key at all falls back to `"Not available for your role. Ask an admin of
+this product."` (plus one `console.warn` outside production, because that input
+is a caller bug).
 
 It takes **one** operation. Choosing which operation to explain — the first one
 `can()` denied, out of the several a button performs — is the caller's job, and
@@ -227,11 +231,26 @@ exactly what the gateway does with an uncatalogued key.
 >
 > ```ts
 > import type { Operation } from '@lessly/sdk-app';
-> export const accessReason = (op: Operation | string): string =>
->   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.`;
+>
+> const ok = (v: unknown): v is string => typeof v === 'string' && v.trim() !== '';
+>
+> export const accessReason = (op: Operation | string): string => {
+>   if (ok(op)) return `Requires access to ${op}. Ask an admin of this product.`;
+>   // A generated method is a CALLABLE carrying operationKey/level, so not just 'object'.
+>   if (op !== null && (typeof op === 'object' || typeof op === 'function')) {
+>     const { operationKey, level } = op as { operationKey?: unknown; level?: unknown };
+>     if (ok(operationKey)) {
+>       return ok(level) && ['read', 'write', 'admin'].includes(level)
+>         ? `Requires level:${level} (${operationKey}). Ask an admin of this product.`
+>         : `Requires access to ${operationKey}. Ask an admin of this product.`;
+>     }
+>   }
+>   return 'Not available for your role. Ask an admin of this product.';
+> };
 > ```
+>
+> It never throws — a render helper that crashes takes the whole screen with it —
+> and never renders `level:undefined`.
 
 **Why both values.** The reason says what an admin has to *grant*, not what the
 caller happens to be — a role name gives them nothing to act on, and "your role

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessly/sdk-app",
-  "version": "63.2.2",
+  "version": "63.2.4",
   "type": "module",
   "sideEffects": false,
   "engines": {
@@ -148,16 +148,6 @@
         "default": "./dist/organization/index.cjs"
       }
     },
-    "./playground": {
-      "import": {
-        "types": "./dist/playground/index.d.ts",
-        "default": "./dist/playground/index.js"
-      },
-      "require": {
-        "types": "./dist/playground/index.d.cts",
-        "default": "./dist/playground/index.cjs"
-      }
-    },
     "./realtime": {
       "import": {
         "types": "./dist/realtime/index.d.ts",
@@ -209,5 +199,5 @@
       }
     }
   },
-  "sdkContentHash": "sha256:965d6441024647f1461d4e50bedeba9d79dca805ea4668ca8c9ecedefc1c0d0a"
+  "sdkContentHash": "sha256:dd29109a46bbe0d03bc1d40d04cb3be51eecfdcc76db40b6eceead9bf9a05f9b"
 }

package/src/gen/bindings.gen.ts

@@ -7116,134 +7116,6 @@ export const bindings: BindingsMap = {
       }
     }
   },
-  "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
-      }
-    },
-    "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
-      }
-    }
-  },
   "realtime": {
     "archive": {
       "export": {
@@ -10425,12 +10297,4 @@ export const bindings: BindingsMap = {
   }
 };
 
-export const wsBindings: WsBindingsMap = {
-  "playground": {
-    "ws": {
-      "echo": {
-        "path": "/playground/ws/echo"
-      }
-    }
-  }
-};
+export const wsBindings: WsBindingsMap = {};

package/src/gen/client.gen.ts

@@ -769,30 +769,6 @@ import type {
   OrganizationXInstallOutput,
   OrganizationYoutubeInstallInput,
   OrganizationYoutubeInstallOutput,
-  PlaygroundAnalyticsOverviewInput,
-  PlaygroundAnalyticsOverviewOutput,
-  PlaygroundBillingEntitlementsInput,
-  PlaygroundBillingEntitlementsOutput,
-  PlaygroundBillingRecordUsageInput,
-  PlaygroundBillingRecordUsageOutput,
-  PlaygroundClickupCreateTaskInput,
-  PlaygroundClickupCreateTaskOutput,
-  PlaygroundClickupGetLastWebhookInput,
-  PlaygroundClickupGetLastWebhookOutput,
-  PlaygroundClickupGetOverviewInput,
-  PlaygroundClickupGetOverviewOutput,
-  PlaygroundGdriveGetLastChangeInput,
-  PlaygroundGdriveGetLastChangeOutput,
-  PlaygroundGdriveReadFileInput,
-  PlaygroundGdriveReadFileOutput,
-  PlaygroundGoogleadsReadCustomerInput,
-  PlaygroundGoogleadsReadCustomerOutput,
-  PlaygroundLifecycleGetStateInput,
-  PlaygroundLifecycleGetStateOutput,
-  PlaygroundLifecycleListEventsInput,
-  PlaygroundLifecycleListEventsOutput,
-  PlaygroundWebhookGetLastInput,
-  PlaygroundWebhookGetLastOutput,
   RealtimeArchiveExportInput,
   RealtimeArchiveExportOutput,
   RealtimeArchiveExportStatusInput,
@@ -1802,34 +1778,6 @@ export interface GeneratedClient {
       install: ((input: OrganizationYoutubeInstallInput) => Promise<OrganizationYoutubeInstallOutput>) & Operation;
     };
   };
-  playground: {
-    analytics: {
-      overview: ((input: PlaygroundAnalyticsOverviewInput) => Promise<PlaygroundAnalyticsOverviewOutput>) & Operation;
-    };
-    billing: {
-      entitlements: ((input: PlaygroundBillingEntitlementsInput) => Promise<PlaygroundBillingEntitlementsOutput>) & Operation;
-      'record-usage': ((input: PlaygroundBillingRecordUsageInput) => Promise<PlaygroundBillingRecordUsageOutput>) & Operation;
-    };
-    clickup: {
-      'create-task': ((input: PlaygroundClickupCreateTaskInput) => Promise<PlaygroundClickupCreateTaskOutput>) & Operation;
-      'get-last-webhook': ((input: PlaygroundClickupGetLastWebhookInput) => Promise<PlaygroundClickupGetLastWebhookOutput>) & Operation;
-      'get-overview': ((input: PlaygroundClickupGetOverviewInput) => Promise<PlaygroundClickupGetOverviewOutput>) & Operation;
-    };
-    gdrive: {
-      'get-last-change': ((input: PlaygroundGdriveGetLastChangeInput) => Promise<PlaygroundGdriveGetLastChangeOutput>) & Operation;
-      'read-file': ((input: PlaygroundGdriveReadFileInput) => Promise<PlaygroundGdriveReadFileOutput>) & Operation;
-    };
-    googleads: {
-      'read-customer': ((input: PlaygroundGoogleadsReadCustomerInput) => Promise<PlaygroundGoogleadsReadCustomerOutput>) & Operation;
-    };
-    lifecycle: {
-      'get-state': ((input: PlaygroundLifecycleGetStateInput) => Promise<PlaygroundLifecycleGetStateOutput>) & Operation;
-      'list-events': ((input: PlaygroundLifecycleListEventsInput) => Promise<PlaygroundLifecycleListEventsOutput>) & Operation;
-    };
-    webhook: {
-      'get-last': ((input: PlaygroundWebhookGetLastInput) => Promise<PlaygroundWebhookGetLastOutput>) & Operation;
-    };
-  };
   realtime: {
     archive: {
       export: ((input: RealtimeArchiveExportInput) => Promise<RealtimeArchiveExportOutput>) & Operation;

package/src/gen/manifest.gen.ts

@@ -1,7 +1,7 @@
 // AUTOGENERATED by scripts/generate.ts — do not edit.
 import type { ToolLevel } from '../runtime/types';
 
-export const namespaces = ['analytics', 'brain', 'consent', 'content', 'deployment', 'mail', 'observe', 'organization', 'playground', 'realtime', 'support', 'tracking', 'users', 'waitlist'] as const;
+export const namespaces = ['analytics', 'brain', 'consent', 'content', 'deployment', 'mail', 'observe', 'organization', 'realtime', 'support', 'tracking', 'users', 'waitlist'] as const;
 
 export const operations: Record<string, ToolLevel> = {
   'analytics_catalog_get': 'read',
@@ -388,18 +388,6 @@ export const operations: Record<string, ToolLevel> = {
   '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_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',
   'realtime_archive_export': 'admin',
   'realtime_archive_export_status': 'read',
   'realtime_archive_get': 'read',

package/src/gen/types.gen.ts

@@ -85727,232 +85727,6 @@ export interface OrganizationYoutubeInstallOutput {
 url: string
 }
 
-export interface PlaygroundAnalyticsOverviewInput {
-/**
- * Max records per entity in recent[]; omit for the endpoint default
- */
-limit?: number
-}
-
-export interface PlaygroundAnalyticsOverviewOutput {
-ok: boolean
-minted: boolean
-overview?: unknown
-http_status: number
-}
-
-export interface PlaygroundBillingEntitlementsInput {
-
-}
-
-export interface PlaygroundBillingEntitlementsOutput {
-ok: boolean
-minted: boolean
-http_status: number
-entitlements?: unknown
-}
-
-export interface PlaygroundBillingRecordUsageInput {
-/**
- * Quantity of events to record against playground-events (SUM); defaults to 1
- */
-value?: number
-}
-
-export interface PlaygroundBillingRecordUsageOutput {
-minted: boolean
-accepted: (number | null)
-recorded: boolean
-duplicates: (number | null)
-http_status: number
-}
-
-export interface PlaygroundClickupCreateTaskInput {
-/**
- * Task title; defaults to a fixture label
- */
-name?: string
-/**
- * ClickUp list id; falls back to CLICKUP_TEST_LIST_ID
- */
-listId?: string
-}
-
-export interface PlaygroundClickupCreateTaskOutput {
-minted: boolean
-task_id: (string | null)
-list_status: number
-vend_status: number
-clickup_status: number
-installation_count: number
-}
-
-export interface PlaygroundClickupGetLastWebhookInput {
-
-}
-
-export type PlaygroundClickupGetLastWebhookOutput = ({
-payload: string
-event_id: string
-provider: string
-verified: boolean
-product_id: string
-occurred_at: string
-connector_id: string
-clickup_event: (string | null)
-receipt_count: number
-} | {
-found: false
-})
-
-export interface PlaygroundClickupGetOverviewInput {
-
-}
-
-export interface PlaygroundClickupGetOverviewOutput {
-team: ({
-teamId: string
-teamName: string
-} | null)
-lists: PlaygroundClickupGetOverviewOutputItems[]
-tasks: {
-id: string
-name: string
-status: (string | null)
-}[]
-minted: boolean
-spaces: PlaygroundClickupGetOverviewOutputItems[]
-list_status: number
-vend_status: number
-lists_status: number
-tasks_status: number
-spaces_status: number
-folders_status: number
-installation_count: number
-}
-export interface PlaygroundClickupGetOverviewOutputItems {
-id: string
-name: string
-}
-
-export interface PlaygroundGdriveGetLastChangeInput {
-
-}
-
-export type PlaygroundGdriveGetLastChangeOutput = ({
-file_id: string
-removed: boolean
-file_name: (string | null)
-mime_type: (string | null)
-product_id: string
-occurred_at: string
-connector_id: string
-resource_state: string
-} | {
-found: false
-})
-
-export interface PlaygroundGdriveReadFileInput {
-/**
- * Drive file id; falls back to GDRIVE_TEST_FILE_ID, then the first picked file
- */
-fileId?: string
-}
-
-export interface PlaygroundGdriveReadFileOutput {
-minted: boolean
-file_id: (string | null)
-file_name: (string | null)
-mime_type: (string | null)
-file_count: number
-get_status: number
-list_status: number
-vend_status: number
-content_bytes: (number | null)
-}
-
-export interface PlaygroundGoogleadsReadCustomerInput {
-
-}
-
-export interface PlaygroundGoogleadsReadCustomerOutput {
-minted: boolean
-vended: boolean
-customer_id: (string | null)
-vend_status: number
-result_count: number
-search_status: number
-login_customer_id: (string | null)
-}
-
-export interface PlaygroundLifecycleGetStateInput {
-
-}
-
-export interface PlaygroundLifecycleGetStateOutput {
-blocked: boolean
-archived: boolean
-productId: string
-lastBlockTransition: ({
-eventId: string
-eventName: string
-productId: string
-occurredAt: string
-recordedAt: string
-receiptCount: number
-organizationId: string
-cascadedFromOrg: boolean
-} | null)
-lastArchiveTransition: ({
-eventId: string
-eventName: string
-productId: string
-occurredAt: string
-recordedAt: string
-receiptCount: number
-organizationId: string
-cascadedFromOrg: boolean
-} | null)
-}
-
-export interface PlaygroundLifecycleListEventsInput {
-
-}
-
-export type PlaygroundLifecycleListEventsOutput = {
-eventId: string
-eventName: string
-productId: string
-occurredAt: string
-recordedAt: string
-receiptCount: number
-organizationId: string
-cascadedFromOrg: boolean
-}[]
-
-export interface PlaygroundWebhookGetLastInput {
-
-}
-
-export type PlaygroundWebhookGetLastOutput = ({
-payload?: unknown
-event_id: string
-provider: string
-verified: boolean
-product_id: string
-occurred_at: string
-connector_id: string
-delivery_count: number
-} | {
-found: false
-})
-
-export interface PlaygroundWsEchoInput {
-
-}
-
-export type PlaygroundWsEchoOutput = unknown;
-
 export interface RealtimeArchiveExportInput {
 /**
  * Only entries with ts <= to_ts (epoch ms)

package/dist/_types/gen/playground/connect.gen.d.ts

@@ -1,3 +0,0 @@
-import type { LesslyStream, LesslyStreamOpener } from '../../runtime/types.js';
-import type { PlaygroundWsEchoInput } from '../types.gen.js';
-export declare const playgroundWsEchoConnect: (sdk: LesslyStreamOpener, input: PlaygroundWsEchoInput) => LesslyStream;

package/dist/_types/gen/playground/index.d.ts

@@ -1,3 +0,0 @@
-export * from './queryOptions.gen.js';
-export * from './connect.gen.js';
-export type { PlaygroundAnalyticsOverviewInput, PlaygroundAnalyticsOverviewOutput, PlaygroundBillingEntitlementsInput, PlaygroundBillingEntitlementsOutput, PlaygroundBillingRecordUsageInput, PlaygroundBillingRecordUsageOutput, PlaygroundClickupCreateTaskInput, PlaygroundClickupCreateTaskOutput, PlaygroundClickupGetLastWebhookInput, PlaygroundClickupGetLastWebhookOutput, PlaygroundClickupGetOverviewInput, PlaygroundClickupGetOverviewOutput, PlaygroundGdriveGetLastChangeInput, PlaygroundGdriveGetLastChangeOutput, PlaygroundGdriveReadFileInput, PlaygroundGdriveReadFileOutput, PlaygroundGoogleadsReadCustomerInput, PlaygroundGoogleadsReadCustomerOutput, PlaygroundLifecycleGetStateInput, PlaygroundLifecycleGetStateOutput, PlaygroundLifecycleListEventsInput, PlaygroundLifecycleListEventsOutput, PlaygroundWebhookGetLastInput, PlaygroundWebhookGetLastOutput, PlaygroundWsEchoInput } from '../types.gen.js';

package/dist/_types/gen/playground/queryOptions.gen.d.ts

@@ -1,50 +0,0 @@
-import type { GeneratedClient } from '../client.gen.js';
-import type { PlaygroundAnalyticsOverviewInput, PlaygroundAnalyticsOverviewOutput, PlaygroundBillingEntitlementsInput, PlaygroundBillingEntitlementsOutput, PlaygroundBillingRecordUsageInput, PlaygroundClickupCreateTaskInput, PlaygroundClickupGetLastWebhookInput, PlaygroundClickupGetLastWebhookOutput, PlaygroundClickupGetOverviewInput, PlaygroundClickupGetOverviewOutput, PlaygroundGdriveGetLastChangeInput, PlaygroundGdriveGetLastChangeOutput, PlaygroundGdriveReadFileInput, PlaygroundGdriveReadFileOutput, PlaygroundGoogleadsReadCustomerInput, PlaygroundGoogleadsReadCustomerOutput, PlaygroundLifecycleGetStateInput, PlaygroundLifecycleGetStateOutput, PlaygroundLifecycleListEventsInput, PlaygroundLifecycleListEventsOutput, PlaygroundWebhookGetLastInput, PlaygroundWebhookGetLastOutput } from '../types.gen.js';
-export declare const playgroundAnalyticsOverviewQueryOptions: (sdk: GeneratedClient, input: PlaygroundAnalyticsOverviewInput) => {
-    queryKey: readonly ["playground", "analytics", "overview", PlaygroundAnalyticsOverviewInput];
-    queryFn: () => Promise<PlaygroundAnalyticsOverviewOutput>;
-};
-export declare const playgroundBillingEntitlementsQueryOptions: (sdk: GeneratedClient, input: PlaygroundBillingEntitlementsInput) => {
-    queryKey: readonly ["playground", "billing", "entitlements", PlaygroundBillingEntitlementsInput];
-    queryFn: () => Promise<PlaygroundBillingEntitlementsOutput>;
-};
-export declare const playgroundBillingRecordUsageMutationOptions: (sdk: GeneratedClient) => {
-    mutationKey: string[];
-    mutationFn: (input: PlaygroundBillingRecordUsageInput) => Promise<import(".").PlaygroundBillingRecordUsageOutput>;
-};
-export declare const playgroundClickupCreateTaskMutationOptions: (sdk: GeneratedClient) => {
-    mutationKey: string[];
-    mutationFn: (input: PlaygroundClickupCreateTaskInput) => Promise<import(".").PlaygroundClickupCreateTaskOutput>;
-};
-export declare const playgroundClickupGetLastWebhookQueryOptions: (sdk: GeneratedClient, input: PlaygroundClickupGetLastWebhookInput) => {
-    queryKey: readonly ["playground", "clickup", "get-last-webhook", PlaygroundClickupGetLastWebhookInput];
-    queryFn: () => Promise<PlaygroundClickupGetLastWebhookOutput>;
-};
-export declare const playgroundClickupGetOverviewQueryOptions: (sdk: GeneratedClient, input: PlaygroundClickupGetOverviewInput) => {
-    queryKey: readonly ["playground", "clickup", "get-overview", PlaygroundClickupGetOverviewInput];
-    queryFn: () => Promise<PlaygroundClickupGetOverviewOutput>;
-};
-export declare const playgroundGdriveGetLastChangeQueryOptions: (sdk: GeneratedClient, input: PlaygroundGdriveGetLastChangeInput) => {
-    queryKey: readonly ["playground", "gdrive", "get-last-change", PlaygroundGdriveGetLastChangeInput];
-    queryFn: () => Promise<PlaygroundGdriveGetLastChangeOutput>;
-};
-export declare const playgroundGdriveReadFileQueryOptions: (sdk: GeneratedClient, input: PlaygroundGdriveReadFileInput) => {
-    queryKey: readonly ["playground", "gdrive", "read-file", PlaygroundGdriveReadFileInput];
-    queryFn: () => Promise<PlaygroundGdriveReadFileOutput>;
-};
-export declare const playgroundGoogleadsReadCustomerQueryOptions: (sdk: GeneratedClient, input: PlaygroundGoogleadsReadCustomerInput) => {
-    queryKey: readonly ["playground", "googleads", "read-customer", PlaygroundGoogleadsReadCustomerInput];
-    queryFn: () => Promise<PlaygroundGoogleadsReadCustomerOutput>;
-};
-export declare const playgroundLifecycleGetStateQueryOptions: (sdk: GeneratedClient, input: PlaygroundLifecycleGetStateInput) => {
-    queryKey: readonly ["playground", "lifecycle", "get-state", PlaygroundLifecycleGetStateInput];
-    queryFn: () => Promise<PlaygroundLifecycleGetStateOutput>;
-};
-export declare const playgroundLifecycleListEventsQueryOptions: (sdk: GeneratedClient, input: PlaygroundLifecycleListEventsInput) => {
-    queryKey: readonly ["playground", "lifecycle", "list-events", PlaygroundLifecycleListEventsInput];
-    queryFn: () => Promise<PlaygroundLifecycleListEventsOutput>;
-};
-export declare const playgroundWebhookGetLastQueryOptions: (sdk: GeneratedClient, input: PlaygroundWebhookGetLastInput) => {
-    queryKey: readonly ["playground", "webhook", "get-last", PlaygroundWebhookGetLastInput];
-    queryFn: () => Promise<PlaygroundWebhookGetLastOutput>;
-};