@mushi-mushi/plugin-zapier 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kenji Sakuramoto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# `@mushi-mushi/plugin-zapier`
+
+Reference Mushi Mushi plugin: forward any Mushi event to a Zapier "Catch
+Hook" trigger so non-engineers can wire Mushi into the rest of the org's
+automation surface (Notion, Sheets, Mailchimp, Slack channels, etc.).
+
+## Install
+
+```bash
+npm i @mushi-mushi/plugin-zapier
+```
+
+## Run as a stand-alone server
+
+```bash
+ZAPIER_HOOK_URL=https://hooks.zapier.com/hooks/catch/.../...
+MUSHI_PLUGIN_SECRET=...
+ALLOW_EVENTS=report.classified,sla.breached    # optional
+DENY_EVENTS=report.dedup_grouped               # optional
+PORT=3000
+npx mushi-plugin-zapier
+```
+
+The handler subscribes to `*` and forwards a flattened payload that Zapier
+can parse without diving into nested objects:
+
+```json
+{
+  "event": "report.classified",
+  "delivery_id": "...",
+  "occurred_at": "...",
+  "project_id": "...",
+  "plugin_slug": "zapier",
+  "report_id": "...",
+  "report_status": "classified",
+  "report_category": "bug",
+  "report_severity": "high",
+  "report_title": "Login button does nothing",
+  "raw": { /* full Mushi envelope */ }
+}
+```
+
+## License
+
+MIT

package/dist/chunk-4NOWCHTE.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { createPluginHandler } from "@mushi-mushi/plugin-sdk";
+function createZapierPlugin(cfg) {
+  const f = cfg.fetchImpl ?? fetch;
+  const allow = new Set(cfg.allowEvents ?? []);
+  const deny = new Set(cfg.denyEvents ?? []);
+  return createPluginHandler({
+    secret: cfg.mushiSecret,
+    on: {
+      "*": async (e) => {
+        if (allow.size > 0 && !allow.has(e.event)) return;
+        if (deny.has(e.event)) return;
+        const flat = flattenForZapier(e);
+        const res = await f(cfg.zapierHookUrl, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(flat)
+        });
+        if (!res.ok) throw new Error(`Zapier hook ${res.status}: ${await res.text()}`);
+      }
+    }
+  });
+}
+function flattenForZapier(e) {
+  const data = e.data ?? {};
+  const report = data.report ?? {};
+  return {
+    event: e.event,
+    delivery_id: e.deliveryId,
+    occurred_at: e.occurredAt,
+    project_id: e.projectId,
+    plugin_slug: e.pluginSlug,
+    report_id: report.id,
+    report_status: report.status,
+    report_category: report.category,
+    report_severity: report.severity,
+    report_title: report.title,
+    raw: e
+  };
+}
+
+export {
+  createZapierPlugin
+};

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import * as _mushi_mushi_plugin_sdk from '@mushi-mushi/plugin-sdk';
+
+/**
+ * Zapier plugin for Mushi Mushi.
+ *
+ * Subscribes to all events (`*`). For each, POSTs a flattened JSON payload
+ * (Zapier dislikes deep nesting in trigger samples) to the configured Zapier
+ * "Catch Hook" URL. Optional event allow/deny lists let users gate which
+ * triggers fire which Zaps.
+ */
+interface ZapierPluginConfig {
+    zapierHookUrl: string;
+    mushiSecret: string;
+    /** Only forward these events (whitelist). If empty, forward everything. */
+    allowEvents?: string[];
+    /** Drop these events (blacklist). Applied after `allowEvents`. */
+    denyEvents?: string[];
+    fetchImpl?: typeof fetch;
+}
+declare function createZapierPlugin(cfg: ZapierPluginConfig): (input: _mushi_mushi_plugin_sdk.HandlePluginRequestInput) => Promise<_mushi_mushi_plugin_sdk.HandlePluginResult>;
+
+export { type ZapierPluginConfig, createZapierPlugin };

package/dist/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import {
+  createZapierPlugin
+} from "./chunk-4NOWCHTE.js";
+export {
+  createZapierPlugin
+};

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/server.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import {
+  createZapierPlugin
+} from "./chunk-4NOWCHTE.js";
+
+// src/server.ts
+import { createServer } from "http";
+var port = Number(process.env.PORT ?? 3e3);
+var handler = createZapierPlugin({
+  zapierHookUrl: required("ZAPIER_HOOK_URL"),
+  mushiSecret: required("MUSHI_PLUGIN_SECRET"),
+  allowEvents: parseList(process.env.ALLOW_EVENTS),
+  denyEvents: parseList(process.env.DENY_EVENTS)
+});
+createServer(async (req, res) => {
+  if (req.method !== "POST" || req.url !== "/mushi/webhook") {
+    res.statusCode = 404;
+    res.end();
+    return;
+  }
+  const chunks = [];
+  req.on("data", (c) => chunks.push(c));
+  req.on("end", async () => {
+    const rawBody = Buffer.concat(chunks).toString("utf8");
+    const headers = {};
+    for (const [k, v] of Object.entries(req.headers)) headers[k] = Array.isArray(v) ? v[0] : v;
+    const result = await handler({ rawBody, headers });
+    res.statusCode = result.status;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(result.body));
+  });
+}).listen(port, () => {
+  console.log(`mushi-plugin-zapier listening on :${port}`);
+});
+function required(name) {
+  const v = process.env[name];
+  if (!v) {
+    console.error(`Missing required env var: ${name}`);
+    process.exit(1);
+  }
+  return v;
+}
+function parseList(v) {
+  return v ? v.split(",").map((s) => s.trim()).filter(Boolean) : [];
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@mushi-mushi/plugin-zapier",
+  "version": "0.2.0",
+  "license": "MIT",
+  "description": "Reference Mushi Mushi plugin: fan out any Mushi event to a Zapier-style incoming webhook.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mushi-plugin-zapier": "./dist/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@mushi-mushi/plugin-sdk": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^10.2.0",
+    "tsup": "^8.4.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4",
+    "@mushi-mushi/eslint-config": "0.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kensaurus/mushi-mushi.git",
+    "directory": "packages/plugin-zapier"
+  },
+  "author": "Kenji Sakuramoto",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "mushi-mushi",
+    "plugin",
+    "zapier",
+    "webhook",
+    "automation"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}