[TDL-192] Rename email forwarders per ADR #12 (#4107)

libs/common/src/email-forwarders/anon-addy-forwarder.ts

@@ -0,0 +1,41 @@
+import { ApiService } from "../abstractions/api.service";
+
+import { Forwarder } from "./forwarder";
+import { ForwarderOptions } from "./forwarder-options";
+
+export class AnonAddyForwarder implements Forwarder {
+  async generate(apiService: ApiService, options: ForwarderOptions): Promise<string> {
+    if (options.apiKey == null || options.apiKey === "") {
+      throw "Invalid AnonAddy API token.";
+    }
+    if (options.anonaddy?.domain == null || options.anonaddy.domain === "") {
+      throw "Invalid AnonAddy domain.";
+    }
+    const requestInit: RequestInit = {
+      redirect: "manual",
+      cache: "no-store",
+      method: "POST",
+      headers: new Headers({
+        Authorization: "Bearer " + options.apiKey,
+        "Content-Type": "application/json",
+      }),
+    };
+    const url = "https://app.anonaddy.com/api/v1/aliases";
+    requestInit.body = JSON.stringify({
+      domain: options.anonaddy.domain,
+      description:
+        (options.website != null ? "Website: " + options.website + ". " : "") +
+        "Generated by Bitwarden.",
+    });
+    const request = new Request(url, requestInit);
+    const response = await apiService.nativeFetch(request);
+    if (response.status === 200 || response.status === 201) {
+      const json = await response.json();
+      return json?.data?.email;
+    }
+    if (response.status === 401) {
+      throw "Invalid AnonAddy API token.";
+    }
+    throw "Unknown AnonAddy error occurred.";
+  }
+}

libs/common/src/email-forwarders/duck-duck-go-forwarder.ts

@@ -0,0 +1,33 @@
+import { ApiService } from "../abstractions/api.service";
+
+import { Forwarder } from "./forwarder";
+import { ForwarderOptions } from "./forwarder-options";
+
+export class DuckDuckGoForwarder implements Forwarder {
+  async generate(apiService: ApiService, options: ForwarderOptions): Promise<string> {
+    if (options.apiKey == null || options.apiKey === "") {
+      throw "Invalid DuckDuckGo API token.";
+    }
+    const requestInit: RequestInit = {
+      redirect: "manual",
+      cache: "no-store",
+      method: "POST",
+      headers: new Headers({
+        Authorization: "Bearer " + options.apiKey,
+        "Content-Type": "application/json",
+      }),
+    };
+    const url = "https://quack.duckduckgo.com/api/email/addresses";
+    const request = new Request(url, requestInit);
+    const response = await apiService.nativeFetch(request);
+    if (response.status === 200 || response.status === 201) {
+      const json = await response.json();
+      if (json.address) {
+        return `${json.address}@duck.com`;
+      }
+    } else if (response.status === 401) {
+      throw "Invalid DuckDuckGo API token.";
+    }
+    throw "Unknown DuckDuckGo error occurred.";
+  }
+}

libs/common/src/email-forwarders/fastmail-forwarder.ts

@@ -0,0 +1,96 @@
+import { ApiService } from "../abstractions/api.service";
+
+import { Forwarder } from "./forwarder";
+import { ForwarderOptions } from "./forwarder-options";
+
+export class FastmailForwarder implements Forwarder {
+  async generate(apiService: ApiService, options: ForwarderOptions): Promise<string> {
+    if (options.apiKey == null || options.apiKey === "") {
+      throw "Invalid Fastmail API token.";
+    }
+
+    const accountId = await this.getAccountId(apiService, options);
+    if (accountId == null || accountId === "") {
+      throw "Unable to obtain Fastmail masked email account ID.";
+    }
+
+    const requestInit: RequestInit = {
+      redirect: "manual",
+      cache: "no-store",
+      method: "POST",
+      headers: new Headers({
+        Authorization: "Bearer " + options.apiKey,
+        "Content-Type": "application/json",
+      }),
+    };
+    const url = "https://api.fastmail.com/jmap/api/";
+    requestInit.body = JSON.stringify({
+      using: ["https://www.fastmail.com/dev/maskedemail", "urn:ietf:params:jmap:core"],
+      methodCalls: [
+        [
+          "MaskedEmail/set",
+          {
+            accountId: accountId,
+            create: {
+              "new-masked-email": {
+                state: "enabled",
+                description: "",
+                url: options.website,
+                emailPrefix: options.fastmail.prefix,
+              },
+            },
+          },
+          "0",
+        ],
+      ],
+    });
+    const request = new Request(url, requestInit);
+    const response = await apiService.nativeFetch(request);
+    if (response.status === 200) {
+      const json = await response.json();
+      if (
+        json.methodResponses != null &&
+        json.methodResponses.length > 0 &&
+        json.methodResponses[0].length > 0
+      ) {
+        if (json.methodResponses[0][0] === "MaskedEmail/set") {
+          if (json.methodResponses[0][1]?.created?.["new-masked-email"] != null) {
+            return json.methodResponses[0][1]?.created?.["new-masked-email"]?.email;
+          }
+          if (json.methodResponses[0][1]?.notCreated?.["new-masked-email"] != null) {
+            throw (
+              "Fastmail error: " +
+              json.methodResponses[0][1]?.notCreated?.["new-masked-email"]?.description
+            );
+          }
+        } else if (json.methodResponses[0][0] === "error") {
+          throw "Fastmail error: " + json.methodResponses[0][1]?.description;
+        }
+      }
+    }
+    if (response.status === 401 || response.status === 403) {
+      throw "Invalid Fastmail API token.";
+    }
+    throw "Unknown Fastmail error occurred.";
+  }
+
+  private async getAccountId(apiService: ApiService, options: ForwarderOptions): Promise<string> {
+    const requestInit: RequestInit = {
+      cache: "no-store",
+      method: "GET",
+      headers: new Headers({
+        Authorization: "Bearer " + options.apiKey,
+      }),
+    };
+    const url = "https://api.fastmail.com/.well-known/jmap";
+    const request = new Request(url, requestInit);
+    const response = await apiService.nativeFetch(request);
+    if (response.status === 200) {
+      const json = await response.json();
+      if (json.primaryAccounts != null) {
+        return json.primaryAccounts["https://www.fastmail.com/dev/maskedemail"];
+      }
+    }
+    return null;
+  }
+}

libs/common/src/email-forwarders/firefox-relay-forwarder.ts

@@ -0,0 +1,38 @@
+import { ApiService } from "../abstractions/api.service";
+
+import { Forwarder } from "./forwarder";
+import { ForwarderOptions } from "./forwarder-options";
+
+export class FirefoxRelayForwarder implements Forwarder {
+  async generate(apiService: ApiService, options: ForwarderOptions): Promise<string> {
+    if (options.apiKey == null || options.apiKey === "") {
+      throw "Invalid Firefox Relay API token.";
+    }
+    const requestInit: RequestInit = {
+      redirect: "manual",
+      cache: "no-store",
+      method: "POST",
+      headers: new Headers({
+        Authorization: "Token " + options.apiKey,
+        "Content-Type": "application/json",
+      }),
+    };
+    const url = "https://relay.firefox.com/api/v1/relayaddresses/";
+    requestInit.body = JSON.stringify({
+      enabled: true,
+      generated_for: options.website,
+      description:
+        (options.website != null ? options.website + " - " : "") + "Generated by Bitwarden.",
+    });
+    const request = new Request(url, requestInit);
+    const response = await apiService.nativeFetch(request);
+    if (response.status === 200 || response.status === 201) {
+      const json = await response.json();
+      return json?.full_address;
+    }
+    if (response.status === 401) {
+      throw "Invalid Firefox Relay API token.";
+    }
+    throw "Unknown Firefox Relay error occurred.";
+  }
+}

libs/common/src/email-forwarders/forwarder-options.ts

@@ -0,0 +1,14 @@
+export class ForwarderOptions {
+  apiKey: string;
+  website: string;
+  fastmail = new FastmailForwarderOptions();
+  anonaddy = new AnonAddyForwarderOptions();
+}
+
+export class FastmailForwarderOptions {
+  prefix: string;
+}
+
+export class AnonAddyForwarderOptions {
+  domain: string;
+}

libs/common/src/email-forwarders/forwarder.ts

@@ -0,0 +1,7 @@
+import { ApiService } from "../abstractions/api.service";
+
+import { ForwarderOptions } from "./forwarder-options";
+
+export interface Forwarder {
+  generate(apiService: ApiService, options: ForwarderOptions): Promise<string>;
+}

libs/common/src/email-forwarders/simple-login-forwarder.ts

@@ -0,0 +1,48 @@
+import { ApiService } from "../abstractions/api.service";
+
+import { Forwarder } from "./forwarder";
+import { ForwarderOptions } from "./forwarder-options";
+
+export class SimpleLoginForwarder implements Forwarder {
+  async generate(apiService: ApiService, options: ForwarderOptions): Promise<string> {
+    if (options.apiKey == null || options.apiKey === "") {
+      throw "Invalid SimpleLogin API key.";
+    }
+    const requestInit: RequestInit = {
+      redirect: "manual",
+      cache: "no-store",
+      method: "POST",
+      headers: new Headers({
+        Authentication: options.apiKey,
+        "Content-Type": "application/json",
+      }),
+    };
+    let url = "https://app.simplelogin.io/api/alias/random/new";
+    if (options.website != null) {
+      url += "?hostname=" + options.website;
+    }
+    requestInit.body = JSON.stringify({
+      note:
+        (options.website != null ? "Website: " + options.website + ". " : "") +
+        "Generated by Bitwarden.",
+    });
+    const request = new Request(url, requestInit);
+    const response = await apiService.nativeFetch(request);
+    if (response.status === 200 || response.status === 201) {
+      const json = await response.json();
+      return json.alias;
+    }
+    if (response.status === 401) {
+      throw "Invalid SimpleLogin API key.";
+    }
+    try {
+      const json = await response.json();
+      if (json?.error != null) {
+        throw "SimpleLogin error:" + json.error;
+      }
+    } catch {
+      // Do nothing...
+    }
+    throw "Unknown SimpleLogin error occurred.";
+  }
+}