refactor: rename request methods to remove send prefix (#161)

* refactor: rename request methods to remove send prefix

Following the MCP TS SDK convention where request methods don't have
the "send" prefix (reserved for notifications):

- App.sendMessage() → App.message()
- App.sendOpenLink() → App.openLink()
- AppBridge.sendResourceTeardown() → AppBridge.resourceTeardown()

The old method names are kept as deprecated aliases for backwards
compatibility.

Updated all examples to use the new method names.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* test: add tests for deprecated method aliases

- Update existing tests to use new method names (message, openLink)
- Add tests verifying deprecated aliases are same reference as new methods
- Add tests verifying deprecated aliases still work functionally

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* 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.

* fix: update examples to use sendMessage instead of message

* fix: update basic-host to use teardownResource

* fix: update threejs-server to use sendMessage

* refactor: remove deprecated app.message alias

The app.message alias was removed since sendMessage is the correct name.
sendResourceTeardown already exists in AppBridge.

* refactor: remove resourceTeardown alias, keep only sendResourceTeardown

---------

Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Olivier Chafik 2025-12-16 22:07:06 +00:00 • committed by GitHub
commit 2dd223b611
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -824,7 +824,7 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
* @example Open documentation link
* ```typescript
* try {
* await app.sendOpenLink({ url: "https://docs.example.com" });
* await app.openLink({ url: "https://docs.example.com" });
* } catch (error) {
* console.error("Failed to open link:", error);
* // Optionally show fallback: display URL for manual copy
@ -833,10 +833,7 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
*
* @see {@link McpUiOpenLinkRequest} for request structure
*/
sendOpenLink(
params: McpUiOpenLinkRequest["params"],
options?: RequestOptions,
) {
openLink(params: McpUiOpenLinkRequest["params"], options?: RequestOptions) {
return this.request(
<McpUiOpenLinkRequest>{
method: "ui/open-link",
@ -847,6 +844,9 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
);
}
/** @deprecated Use {@link openLink} instead */
sendOpenLink: App["openLink"] = this.openLink;
/**
* Request a change to the display mode.
*