Added Component Form.taxi

components/form_taxi/README.md

@@ -0,0 +1,7 @@
+# Overview
+
+Form.taxi provides a simple and secure way to handle form submissions without writing any server-side code. With Form.taxi, you can quickly connect your HTML forms and deliver submissions or integrate them into your existing workflows. By using Pipedream, you can automate actions in response to new form submissions—such as storing data, sending notifications, or connecting with third-party apps—making it easy to streamline processes and boost productivity.
+
+# Troubleshooting
+
+If you have issues with this integration, please reach out at [[email protected]](mailto:[email protected]).

components/form_taxi/form_taxi.app.mjs

@@ -1,11 +1,50 @@
+import { axios } from "@pipedream/platform";
+
 export default {
+  propDefinitions: {},
   type: "app",
   app: "form_taxi",
-  propDefinitions: {},
   methods: {
-    // this.$auth contains connected account data
-    authKeys() {
-      console.log(Object.keys(this.$auth));
+    _baseUrl() {
+      return "https://form.taxi/int/pipedream/api/";
+    },
+    _makeRequest({
+      $ = this, path, headers, ...opts
+    }) {
+      return axios($, {
+        url: this._baseUrl() + path,
+        headers: {
+          ...headers,
+          "Accept": "application/json",
+          "Content-Type": "application/json",
+          "Api-Key": this.$auth.api_key,
+        },
+        ...opts,
+      });
+    },
+    async createWebhook(hook_url) {
+      return this._makeRequest({
+        method: "POST",
+        path: this.$auth.form_code,
+        data: {
+          hook_url,
+        },
+      });
+    },
+    async deleteWebhook(id) {
+      return this._makeRequest({
+        method: "DELETE",
+        path: this.$auth.form_code,
+        params: {
+          "hook_id": id,
+        },
+      });
+    },
+    async getSampleData() {
+      return this._makeRequest({
+        method: "GET",
+        path: this.$auth.form_code,
+      });
     },
   },
-};
+};

components/form_taxi/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@pipedream/form_taxi",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Pipedream Form.taxi Components",
   "main": "form_taxi.app.mjs",
   "keywords": [
     "pipedream",
     "form_taxi"
   ],
-  "homepage": "https://pipedream.com/apps/form_taxi",
+  "homepage": "https://pipedream.com/apps/form-taxi",
   "author": "Pipedream <[email protected]> (https://pipedream.com/)",
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@pipedream/platform": "^3.1.1"
   }
-}
+}

components/form_taxi/sources/common/base.mjs

@@ -0,0 +1,189 @@
+import formTaxi from "../../form_taxi.app.mjs";
+
+export default {
+  props: {
+    formTaxi,
+    db: "$.service.db",
+    http: {
+      type: "$.interface.http",
+      customResponse: true,
+    },
+  },
+  methods: {
+    async registerWebhook() {
+      const targetUrl = this.http.endpoint;
+      const resp = await this.formTaxi.createWebhook(targetUrl);
+
+      if (resp.status < 200 || resp.status >= 300) {
+        const msg = resp?.data?.message || "Unknown error";
+        throw new Error(
+          `Error (${resp.status}): ${msg}`,
+        );
+      }
+
+      const id = resp?.id;
+      const expires_at = resp?.expires_at;
+
+      if (!id) throw new Error("Response without id!");
+      if (!expires_at) throw new Error("Response without Expire-Date!");
+
+      await this.db.set("webhookId", id);
+      await this.db.set("webhookExpiresAt", expires_at);
+
+      return resp;
+    },
+    async deleteWebhookById(hookId) {
+      if (!hookId) return;
+      const resp = await this.formTaxi.deleteWebhook(hookId);
+      if (resp.status >= 400) {
+        const msg = resp?.message || "Unknown error";
+        console.warn(`Webhook-Delete failed: ${resp.status} ${msg}`);
+      }
+    },
+    async deleteWebhook() {
+      const webhookId = await this.db.get("webhookId");
+      if (!webhookId) return;
+      await this.deleteWebhookById(webhookId);
+    },
+    msUntilExpiry(expiresAtIso) {
+      if (!expiresAtIso) return null;
+      const expMs = Date.parse(expiresAtIso);
+      if (Number.isNaN(expMs)) return null;
+      return expMs - Date.now();
+    },
+    async ensureWebhookFresh() {
+      const webhookId = await this.db.get("webhookId");
+      const expiresAt = await this.db.get("webhookExpiresAt");
+
+      const msLeft = this.msUntilExpiry(expiresAt);
+      const windowMs = 60 * 60 * 1000;
+
+      const shouldRenew =
+        !webhookId ||
+        !msLeft ||
+        msLeft <= 0 ||
+        msLeft < windowMs;
+
+      if (!shouldRenew) return;
+
+      try {
+        const oldId = webhookId;
+        const res = await this.registerWebhook();
+
+        if (oldId && res?.id && res.id !== oldId) {
+          await this.deleteWebhookById(oldId);
+        }
+
+        console.log(`Webhook renewed. New ID: ${res?.id || "unknown"}, expires at: ${res?.expires_at || "unknown"}`);
+      } catch (err) {
+        console.error(`Automatic renewal failed: ${err.message}`);
+      }
+    },
+    eventIdFromBody(body) {
+      return (
+        body?._id ||
+        `${Date.now()}-${Math.random()
+          .toString(36)
+          .slice(2)}`
+      );
+    },
+    async fetchAndEmitSamples() {
+      try {
+        const resp = await this.formTaxi.getSampleData();
+        if (resp.status < 200 || resp.status >= 300) {
+          const msg = resp?.message || "Unknown error";
+          console.warn(`Sample-GET failed (${resp.status}): ${msg}`);
+          return;
+        }
+
+        const data = resp;
+        if (!data) {
+          console.warn("Sample-GET: empty response");
+          return;
+        }
+
+        const emitOne = (obj) => {
+          const id = this.eventIdFromBody(obj || {}) || `sample-${Date.now()}`;
+          const ts =
+            (obj?.created_at && Date.parse(obj.created_at)) ||
+            Date.now();
+
+          this.$emit(
+            {
+              headers: {
+                "x-sample": "true",
+              },
+              query: {},
+              body: obj,
+              received_at: new Date().toISOString(),
+              source: "Form.taxi",
+              sample: true,
+            },
+            {
+              id,
+              summary: "Sample submission",
+              ts,
+            },
+          );
+        };
+
+        if (Array.isArray(data)) {
+          data.forEach(emitOne);
+        } else if (typeof data === "object") {
+          emitOne(data);
+        } else {
+          console.warn("Sample-GET: unknown format", data);
+        }
+      } catch (err) {
+        console.error(`Sample-GET Exception: ${err.message}`);
+      }
+    },
+  },
+  hooks: {
+    async deploy() {
+      await this.fetchAndEmitSamples();
+    },
+    async activate() {
+      const res = await this.registerWebhook();
+      console.log("Webhook registered:", res);
+    },
+    async deactivate() {
+      try {
+        await this.deleteWebhook();
+      } catch (err) {
+        console.warn("Error removing the webhook:", err.message);
+      }
+    },
+  },
+  async run(event) {
+    await this.ensureWebhookFresh();
+
+    await this.http.respond({
+      status: 200,
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        ok: true,
+      }),
+    });
+
+    const id = this.eventIdFromBody(event.body || {});
+    const summary = `Form Submission ID: ${id}`;
+    const ts = (event.body?.created_at && Date.parse(event.body.created_at)) || Date.now();
+
+    const payload = {
+      headers: event.headers,
+      query: event.query,
+      body: event.body,
+      received_at: new Date().toISOString(),
+      source: "Form.taxi",
+    };
+
+    this.$emit(payload, {
+      id,
+      summary: summary,
+      ts,
+    });
+  },
+};

components/form_taxi/sources/new-form-submission/new-form-submission.mjs

@@ -0,0 +1,14 @@
+import base from "../common/base.mjs";
+
+export default {
+  ...base,
+  type: "source",
+  name: "New Form Submission",
+  key: "form_taxi-new-form-submission",
+  version: "0.0.1",
+  description: "Emit new event when Form.taxi receives a new form submission. [About Form.taxi](https://form.taxi/en/backend)",
+  dedupe: "unique",
+  methods: {
+    ...base.methods,
+  },
+};