refactor: rename message→sendMessage, resourceTeardown→teardownResource

- App.message() → App.sendMessage() (with deprecated message alias)
- AppBridge.resourceTeardown() → AppBridge.teardownResource() (with deprecated aliases)

This better follows the pattern where methods that send data have 'send' or action verb prefix.

Author: ochafik

src/app-bridge.test.ts

@@ -369,20 +369,20 @@ describe("App <-> AppBridge integration", () => {
       await newBridgeTransport.close();
     });
 
-    it("sendResourceTeardown triggers app.onteardown", async () => {
+    it("teardownResource triggers app.onteardown", async () => {
       let teardownCalled = false;
       app.onteardown = async () => {
         teardownCalled = true;
         return {};
       };
 
       await app.connect(appTransport);
-      await bridge.sendResourceTeardown({});
+      await bridge.teardownResource({});
 
       expect(teardownCalled).toBe(true);
     });
 
-    it("sendResourceTeardown waits for async cleanup", async () => {
+    it("teardownResource waits for async cleanup", async () => {
       const cleanupSteps: string[] = [];
       app.onteardown = async () => {
         cleanupSteps.push("start");
@@ -392,7 +392,7 @@ describe("App <-> AppBridge integration", () => {
       };
 
       await app.connect(appTransport);
-      await bridge.sendResourceTeardown({});
+      await bridge.teardownResource({});
 
       expect(cleanupSteps).toEqual(["start", "done"]);
     });
@@ -442,15 +442,15 @@ describe("App <-> AppBridge integration", () => {
       await bridge.connect(bridgeTransport);
     });
 
-    it("app.message triggers bridge.onmessage and returns result", async () => {
+    it("app.sendMessage triggers bridge.onmessage and returns result", async () => {
       const receivedMessages: unknown[] = [];
       bridge.onmessage = async (params) => {
         receivedMessages.push(params);
         return {};
       };
 
       await app.connect(appTransport);
-      const result = await app.message({
+      const result = await app.sendMessage({
         role: "user",
         content: [{ type: "text", text: "Hello from app" }],
       });
@@ -463,13 +463,13 @@ describe("App <-> AppBridge integration", () => {
       expect(result).toEqual({});
     });
 
-    it("app.message returns error result when handler indicates error", async () => {
+    it("app.sendMessage returns error result when handler indicates error", async () => {
       bridge.onmessage = async () => {
         return { isError: true };
       };
 
       await app.connect(appTransport);
-      const result = await app.message({
+      const result = await app.sendMessage({
         role: "user",
         content: [{ type: "text", text: "Test" }],
       });
@@ -509,26 +509,30 @@ describe("App <-> AppBridge integration", () => {
       await app.connect(appTransport);
     });
 
-    it("app.sendMessage is an alias for app.message", async () => {
-      expect(app.sendMessage).toBe(app.message);
+    it("app.message is a deprecated alias for app.sendMessage", async () => {
+      expect(app.message).toBe(app.sendMessage);
     });
 
     it("app.sendOpenLink is an alias for app.openLink", async () => {
       expect(app.sendOpenLink).toBe(app.openLink);
     });
 
-    it("bridge.sendResourceTeardown is an alias for bridge.resourceTeardown", () => {
-      expect(bridge.sendResourceTeardown).toBe(bridge.resourceTeardown);
+    it("bridge.resourceTeardown is a deprecated alias for bridge.teardownResource", () => {
+      expect(bridge.resourceTeardown).toBe(bridge.teardownResource);
     });
 
-    it("app.sendMessage works as deprecated alias", async () => {
+    it("bridge.sendResourceTeardown is a deprecated alias for bridge.teardownResource", () => {
+      expect(bridge.sendResourceTeardown).toBe(bridge.teardownResource);
+    });
+
+    it("app.message works as deprecated alias", async () => {
       const receivedMessages: unknown[] = [];
       bridge.onmessage = async (params) => {
         receivedMessages.push(params);
         return {};
       };
 
-      await app.sendMessage({
+      await app.message({
         role: "user",
         content: [{ type: "text", text: "Via deprecated alias" }],
       });

src/app-bridge.ts

@@ -131,7 +131,7 @@ type RequestHandlerExtra = Parameters<
  * 2. **Connect**: Call `connect()` with transport to establish communication
  * 3. **Wait for init**: Guest UI sends initialize request, bridge responds
  * 4. **Send data**: Call `sendToolInput()`, `sendToolResult()`, etc.
- * 5. **Teardown**: Call `sendResourceTeardown()` before unmounting iframe
+ * 5. **Teardown**: Call `teardownResource()` before unmounting iframe
  *
  * @example Basic usage
  * ```typescript
@@ -1174,15 +1174,15 @@ export class AppBridge extends Protocol<
    * @example
    * ```typescript
    * try {
-   *   await bridge.resourceTeardown({});
+   *   await bridge.teardownResource({});
    *   // Guest UI is ready, safe to unmount iframe
    *   iframe.remove();
    * } catch (error) {
    *   console.error("Teardown failed:", error);
    * }
    * ```
    */
-  resourceTeardown(
+  teardownResource(
     params: McpUiResourceTeardownRequest["params"],
     options?: RequestOptions,
   ) {
@@ -1196,8 +1196,10 @@ export class AppBridge extends Protocol<
     );
   }
 
-  /** @deprecated Use {@link resourceTeardown} instead */
-  sendResourceTeardown: AppBridge["resourceTeardown"] = this.resourceTeardown;
+  /** @deprecated Use {@link teardownResource} instead */
+  resourceTeardown: AppBridge["teardownResource"] = this.teardownResource;
+  /** @deprecated Use {@link teardownResource} instead */
+  sendResourceTeardown: AppBridge["teardownResource"] = this.teardownResource;
 
   /**
    * Connect to the Guest UI via transport and optionally set up message forwarding.

src/app.ts

@@ -758,7 +758,7 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
    * @example Send a text message from user interaction
    * ```typescript
    * try {
-   *   await app.message({
+   *   await app.sendMessage({
    *     role: "user",
    *     content: [{ type: "text", text: "Show me details for item #42" }]
    *   });
@@ -770,7 +770,7 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
    *
    * @see {@link McpUiMessageRequest} for request structure
    */
-  message(params: McpUiMessageRequest["params"], options?: RequestOptions) {
+  sendMessage(params: McpUiMessageRequest["params"], options?: RequestOptions) {
     return this.request(
       <McpUiMessageRequest>{
         method: "ui/message",
@@ -781,8 +781,8 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
     );
   }
 
-  /** @deprecated Use {@link message} instead */
-  sendMessage: App["message"] = this.message;
+  /** @deprecated Use {@link sendMessage} instead */
+  message: App["sendMessage"] = this.sendMessage;
 
   /**
    * Send log messages to the host for debugging and telemetry.

src/generated/schema.ts

@@ -364,7 +364,7 @@ export interface McpUiHostContextChangedNotification {
 
 /**
  * @description Request for graceful shutdown of the Guest UI (Host -> Guest UI).
- * @see {@link app-bridge.AppBridge.sendResourceTeardown} for the host method that sends this
+ * @see {@link app-bridge.AppBridge.teardownResource} for the host method that sends this
  */
 export interface McpUiResourceTeardownRequest {
   method: "ui/resource-teardown";