@lessly/sdk-app 61.0.0 → 61.0.1

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

@@ -1 +1,3 @@
+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/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