ifttt.ts

/** From https://github.com/SidU/teams-langchain-js/wiki/Connecting-IFTTT-Services.

# Creating a webhook
- Go to https://ifttt.com/create

# Configuring the "If This"
- Click on the "If This" button in the IFTTT interface.
- Search for "Webhooks" in the search bar.
- Choose the first option for "Receive a web request with a JSON payload."
- Choose an Event Name that is specific to the service you plan to connect to.
This will make it easier for you to manage the webhook URL.
For example, if you're connecting to Spotify, you could use "Spotify" as your
Event Name.
- Click the "Create Trigger" button to save your settings and create your webhook.

# Configuring the "Then That"
- Tap on the "Then That" button in the IFTTT interface.
- Search for the service you want to connect, such as Spotify.
- Choose an action from the service, such as "Add track to a playlist".
- Configure the action by specifying the necessary details, such as the playlist name,
e.g., "Songs from AI".
- Reference the JSON Payload received by the Webhook in your action. For the Spotify
scenario, choose "{{JsonPayload}}" as your search query.
- Tap the "Create Action" button to save your action settings.
- Once you have finished configuring your action, click the "Finish" button to
complete the setup.
- Congratulations! You have successfully connected the Webhook to the desired
service, and you're ready to start receiving data and triggering actions 🎉

# Finishing up
- To get your webhook URL go to https://ifttt.com/maker_webhooks/settings
- Copy the IFTTT key value from there. The URL is of the form
https://maker.ifttt.com/use/YOUR_IFTTT_KEY. Grab the YOUR_IFTTT_KEY value.
 */
import { Tool } from "@langchain/core/tools";

/**
 * Represents a tool for creating and managing webhooks with the IFTTT (If
 * This Then That) service. The IFTTT service allows users to create
 * chains of simple conditional statements, called applets, which are
 * triggered based on changes to other web services.
 */
export class IFTTTWebhook extends Tool {
  static lc_name() {
    return "IFTTTWebhook";
  }

  private url: string;

  name: string;

  description: string;

  constructor(url: string, name: string, description: string) {
    super(...arguments);
    this.url = url;
    this.name = name;
    this.description = description;
  }

  /** @ignore */
  async _call(input: string): Promise<string> {
    const headers = { "Content-Type": "application/json" };
    const body = JSON.stringify({ this: input });

    const response = await fetch(this.url, {
      method: "POST",
      headers,
      body,
    });

    if (!response.ok) {
      throw new Error(`HTTP error ${response.status}`);
    }

    const result = await response.text();
    return result;
  }
}