@lessly/sdk-app 60.0.0 → 61.0.1

package/dist/_types/gen/manifest.gen.d.ts

@@ -1 +1,3 @@
-export declare const namespaces: readonly ["analytics", "brain", "consent", "content", "deployment", "mail", "observe", "organization", "playground", "realtime", "support", "tracking", "users", "waitlist"];
+import type { ToolLevel } from '../runtime/types.js';
+export declare const namespaces: readonly ["analytics", "brain", "consent", "content", "deployment", "mail", "observe", "organization", "realtime", "support", "tracking", "users", "waitlist"];
+export declare const operations: Record<string, ToolLevel>;

package/dist/_types/gen/types.gen.d.ts

@@ -90626,7 +90626,6 @@ export interface OrganizationProductListAccessOutput {
     orgRoles: {
         id: string;
         name: string;
-        description: (string | null);
     }[];
     canManage: boolean;
     inherited: {
@@ -90977,197 +90976,6 @@ export interface OrganizationSupportThreadsListOutput {
         lastMessagePreview: (string | null);
     }[];
 }
-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/index.d.ts

@@ -2,6 +2,6 @@ export { createLesslyApp } from './runtime/createLesslyApp.js';
 export type { LesslyClientBase } from './runtime/createLesslyApp.js';
 export { connectStream } from './runtime/connectStream.js';
 export { LesslyApiError } from './runtime/errors.js';
-export type { LesslyAppOptions, HttpMethod, Binding, BindingsMap, ParamSpec, ParamIn } from './runtime/types.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 { GeneratedClient } from './gen/client.gen.js';

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

@@ -1,9 +1,9 @@
-import type { Binding, LesslyAppOptions } from './types.js';
+import type { RouteSpec, LesslyAppOptions } from './types.js';
 export interface ResolvedRequest {
     path: string;
     query: Record<string, unknown>;
     body: Record<string, unknown> | undefined;
 }
-export declare function resolveRequest(binding: Binding, input?: Record<string, unknown>): ResolvedRequest;
+export declare function resolveRequest(binding: RouteSpec, input?: Record<string, unknown>): ResolvedRequest;
 export declare function buildUrl(baseUrl: string, path: string, query: Record<string, unknown>): string;
-export declare function executeRequest(opts: LesslyAppOptions, binding: Binding, input?: Record<string, unknown>): Promise<unknown>;
+export declare function executeRequest(opts: LesslyAppOptions, binding: RouteSpec, input?: Record<string, unknown>): Promise<unknown>;

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

@@ -4,12 +4,41 @@ export interface ParamSpec {
     name: string;
     in: ParamIn;
 }
-export interface Binding {
+/**
+ * The access level a tool requires, as declared by the platform catalog. Ordered by increasing
+ * privilege — a caller granted `admin` implicitly satisfies `write` and `read` — but that ordering
+ * is the access check's business; this SDK only transports the value it was given.
+ */
+export type ToolLevel = 'read' | 'write' | 'admin';
+/**
+ * The identity of a catalog operation, carried by both a `Binding` and every generated method.
+ * `operationKey` is the catalog tool name verbatim (`mail_domains_create`), which is what an
+ * access decision keys on — the accessor path (`sdk.mail.domains.create`) is a derived, LOSSY view
+ * of it (a hyphenated resource joins several id segments) and must never be reconstructed by a
+ * caller.
+ */
+export interface Operation {
+    readonly operationKey: string;
+    readonly level: ToolLevel;
+}
+/**
+ * Everything the request layer needs to turn an input object into a URL and a method — and
+ * NOTHING else. Split out of `Binding` when `Binding` grew `operationKey`/`level`: routing has no
+ * business knowing an operation's identity or access level, and `connectStream` (which builds a
+ * GET-shaped route from a `WsBinding`) would otherwise have to fabricate both.
+ */
+export interface RouteSpec {
     method: HttpMethod;
     path: string;
-    readOnly: boolean;
     params?: ParamSpec[];
 }
+/** A REST route plus the catalog identity of the operation it serves. */
+export interface Binding extends RouteSpec {
+    readOnly: boolean;
+    /** Catalog tool name, e.g. `mail_domains_create` — the key an access decision is made on. */
+    operationKey: string;
+    level: ToolLevel;
+}
 /**
  * The streaming counterpart of `Binding`: the upgrade route of a ws-bound tool. No method (an
  * upgrade is always a GET) and no `readOnly` (a socket is neither a read nor a write — the tool's