n8n-nodes-fizzy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rob Zolkos
+
+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,159 @@
+# n8n-nodes-fizzy
+
+[![n8n.io - Workflow Automation](https://img.shields.io/badge/n8n-community%20node-ff6d5a)](https://n8n.io)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![CI](https://github.com/robzolkos/n8n-nodes-fizzy/actions/workflows/ci.yml/badge.svg)](https://github.com/robzolkos/n8n-nodes-fizzy/actions/workflows/ci.yml)
+
+This is an n8n community node that lets you integrate [Fizzy](https://fizzy.do) into your n8n workflows.
+
+Fizzy is 37signals' simple, opinionated kanban tool that helps teams focus on what matters. With this node, you can automate your Fizzy boards, cards, comments, and more—connecting them to hundreds of other services in n8n.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+## What You Can Do
+
+### Automate Your Workflow
+- **Create cards automatically** from emails, Slack messages, or form submissions
+- **Sync cards** with your CRM, helpdesk, or other project tools
+- **Get notified** in Slack, Discord, or email when cards are assigned or completed
+- **Generate reports** by pulling card data into spreadsheets or dashboards
+
+### React to Events in Real-Time
+The **Fizzy Trigger** node listens for webhook events, so your workflows fire instantly when:
+- A new card is added
+- A card is moved to a column
+- Someone is assigned or unassigned
+- A card is moved to "Done", reopened, or moved to "Not Now"
+- A comment is added
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+**Quick install via npm:**
+```bash
+npm install n8n-nodes-fizzy
+```
+
+Or search for "Fizzy" in the n8n community nodes panel.
+
+## Nodes
+
+### Fizzy
+
+The main node for interacting with your Fizzy data. Supports full CRUD operations across all Fizzy resources.
+
+| Resource | Operations |
+|----------|------------|
+| **Board** | Get, Get Many, Create, Update, Delete |
+| **Card** | Get, Get Many, Create, Update, Delete, Close, Reopen, Move to Column, Move to Not Now, Send to Triage, Toggle Tag, Toggle Assignment, Watch, Unwatch |
+| **Column** | Get, Get Many, Create, Update, Delete |
+| **Comment** | Get, Get Many, Create, Update, Delete |
+| **Reaction** | Get Many, Create, Delete |
+| **Step** | Get, Create, Update, Delete |
+| **Tag** | Get Many |
+| **User** | Get, Get Many, Update, Deactivate |
+| **Notification** | Get Many, Mark as Read, Mark as Unread, Mark All as Read |
+
+### Fizzy Trigger
+
+A webhook-based trigger node that starts workflows when events happen in Fizzy.
+
+| Event | Description |
+|-------|-------------|
+| Card Added | A new card is created |
+| Card Assigned | Someone is assigned to a card |
+| Card Board Changed | A card is moved to a different board |
+| Card Column Changed | A card is moved to a column |
+| Card Moved Back to "Maybe?" | A card is sent back to triage |
+| Card Moved to "Done" | A card is closed |
+| Card Moved to "Not Now" | A card is postponed |
+| Card Moved to "Not Now" Due to Inactivity | A card is automatically postponed due to inactivity |
+| Card Reopened | A card is reopened from Done |
+| Card Unassigned | Someone is removed from a card |
+| Comment Added | A comment is added to a card |
+
+Webhook payloads can be verified using HMAC-SHA256 signature verification for security.
+
+## Credentials
+
+To connect n8n to Fizzy, you'll need:
+
+1. **API Token** - Generate a personal access token from your Fizzy account settings
+2. **Base URL** (optional) - Defaults to `https://app.fizzy.do`. Change this if you're using a self-hosted instance.
+
+### Setting Up Credentials
+
+1. In n8n, go to **Credentials** → **New Credential**
+2. Search for "Fizzy API"
+3. Enter your API token
+4. (Optional) Update the base URL if self-hosting
+5. Click **Test Connection** to verify
+
+## Compatibility
+
+- **Minimum n8n version:** 1.0.0
+- **Node.js:** v20 or higher
+- **Tested with:** n8n 1.70.0+
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/robzolkos/n8n-nodes-fizzy.git
+cd n8n-nodes-fizzy
+npm install
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run build` | Compile TypeScript to JavaScript |
+| `npm run lint` | Validate node structure against n8n requirements |
+| `npm run lintfix` | Auto-fix linting issues |
+| `npm run test` | Run unit tests |
+| `npm run test:watch` | Run tests in watch mode |
+| `npm run dev` | Start n8n with hot-reload for development |
+
+### Testing with Docker
+
+Run n8n in Docker with your local node mounted:
+
+```bash
+# Build the node first
+npm run build
+
+# Start n8n with the custom node
+docker run -it --rm -p 5678:5678 \
+  -v $(pwd)/dist:/home/node/.n8n/custom/n8n-nodes-fizzy \
+  -e N8N_CUSTOM_EXTENSIONS="/home/node/.n8n/custom" \
+  n8nio/n8n
+
+# Open http://localhost:5678 and search for "Fizzy"
+```
+
+## Example Workflows
+
+### Slack → Fizzy Card
+Create a Fizzy card whenever someone posts in a specific Slack channel.
+
+### Fizzy → Google Sheets Report
+When a card is closed, append its details to a Google Sheet for tracking completed work.
+
+### Email → Fizzy Triage
+Forward emails to a webhook that creates cards in your Fizzy triage column.
+
+### Fizzy Assignment → Slack DM
+Notify team members via Slack DM when they're assigned to a card.
+
+## Resources
+
+- [Fizzy](https://fizzy.do) - Official Fizzy website
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [n8n Community Forum](https://community.n8n.io/)
+
+## License
+
+[MIT](LICENSE)

package/dist/credentials/FizzyApi.credentials.d.ts

@@ -0,0 +1,14 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class FizzyApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: {
+        readonly light: "file:fizzy.svg";
+        readonly dark: "file:fizzy.svg";
+    };
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=FizzyApi.credentials.d.ts.map

package/dist/credentials/FizzyApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FizzyApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/FizzyApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EAChB,MAAM,cAAc,CAAC;AAEtB,qBAAa,QAAS,YAAW,eAAe;IAC9C,IAAI,SAAc;IAClB,WAAW,SAAe;IAC1B,IAAI;;;MAAgE;IACpE,gBAAgB,SAA6D;IAE7E,UAAU,EAAE,eAAe,EAAE,CAkB3B;IAEF,YAAY,EAAE,oBAAoB,CAOhC;IAEF,IAAI,EAAE,sBAAsB,CAS1B;CACH"}

package/dist/credentials/FizzyApi.credentials.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FizzyApi = void 0;
+class FizzyApi {
+    name = 'fizzyApi';
+    displayName = 'Fizzy API';
+    icon = { light: 'file:fizzy.svg', dark: 'file:fizzy.svg' };
+    documentationUrl = 'https://github.com/basecamp/fizzy/blob/main/docs/API.md';
+    properties = [
+        {
+            displayName: 'API Token',
+            name: 'apiToken',
+            type: 'string',
+            typeOptions: { password: true },
+            default: '',
+            required: true,
+            description: 'Your Fizzy API token. Generate one from your Fizzy account settings.',
+        },
+        {
+            displayName: 'Base URL',
+            name: 'baseUrl',
+            type: 'string',
+            default: 'https://app.fizzy.do',
+            required: true,
+            description: 'The base URL of your Fizzy instance',
+        },
+    ];
+    authenticate = {
+        type: 'generic',
+        properties: {
+            headers: {
+                Authorization: '=Bearer {{$credentials.apiToken}}',
+            },
+        },
+    };
+    test = {
+        request: {
+            baseURL: '={{$credentials.baseUrl}}',
+            url: '/my/identity',
+            method: 'GET',
+            headers: {
+                Accept: 'application/json',
+            },
+        },
+    };
+}
+exports.FizzyApi = FizzyApi;
+//# sourceMappingURL=FizzyApi.credentials.js.map

package/dist/credentials/FizzyApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FizzyApi.credentials.js","sourceRoot":"","sources":["../../credentials/FizzyApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,QAAQ;IACnB,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,WAAW,CAAC;IAC1B,IAAI,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,EAAW,CAAC;IACpE,gBAAgB,GAAG,yDAAyD,CAAC;IAE7E,UAAU,GAAsB;QAC9B;YACE,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/B,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,sEAAsE;SACpF;QACD;YACE,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,qCAAqC;SACnD;KACF,CAAC;IAEF,YAAY,GAAyB;QACnC,IAAI,EAAE,SAAS;QACf,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,aAAa,EAAE,mCAAmC;aACnD;SACF;KACF,CAAC;IAEF,IAAI,GAA2B;QAC7B,OAAO,EAAE;YACP,OAAO,EAAE,2BAA2B;YACpC,GAAG,EAAE,cAAc;YACnB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;aAC3B;SACF;KACF,CAAC;CACH;AA7CD,4BA6CC"}

package/dist/credentials/fizzy.svg

@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <defs>
+    <linearGradient id="fizzyGradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#667eea;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#764ba2;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  <rect width="64" height="64" rx="12" ry="12" fill="url(#fizzyGradient)"/>
+  <g fill="#ffffff">
+    <!-- Fizzy bubbles representing effervescence -->
+    <circle cx="20" cy="44" r="4"/>
+    <circle cx="32" cy="36" r="5"/>
+    <circle cx="44" cy="42" r="3.5"/>
+    <circle cx="26" cy="26" r="3"/>
+    <circle cx="40" cy="24" r="4"/>
+    <circle cx="34" cy="16" r="2.5"/>
+    <circle cx="22" cy="18" r="2"/>
+    <circle cx="46" cy="32" r="2.5"/>
+    <circle cx="18" cy="34" r="2"/>
+  </g>
+</svg>

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './credentials/FizzyApi.credentials';
+export * from './nodes/Fizzy/Fizzy.node';
+export * from './nodes/Fizzy/FizzyTrigger.node';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./credentials/FizzyApi.credentials"), exports);
+__exportStar(require("./nodes/Fizzy/Fizzy.node"), exports);
+__exportStar(require("./nodes/Fizzy/FizzyTrigger.node"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAmD;AACnD,2DAAyC;AACzC,kEAAgD"}

package/dist/nodes/Fizzy/Fizzy.node.d.ts

@@ -0,0 +1,19 @@
+import type { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodeType, INodeTypeDescription, INodeListSearchResult, INodePropertyOptions } from 'n8n-workflow';
+export declare class Fizzy implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getAccounts(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getColumns(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getTags(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getUsers(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+        listSearch: {
+            searchBoards(this: ILoadOptionsFunctions, filter?: string): Promise<INodeListSearchResult>;
+            searchCards(this: ILoadOptionsFunctions, filter?: string): Promise<INodeListSearchResult>;
+            searchComments(this: ILoadOptionsFunctions, filter?: string): Promise<INodeListSearchResult>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=Fizzy.node.d.ts.map

package/dist/nodes/Fizzy/Fizzy.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fizzy.node.d.ts","sourceRoot":"","sources":["../../../nodes/Fizzy/Fizzy.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EAEpB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAiCtB,qBAAa,KAAM,YAAW,SAAS;IACrC,WAAW,EAAE,oBAAoB,CAuE/B;IAEF,OAAO;;8BAEqB,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;6BAIxD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;0BAQ1D,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;2BAQtD,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;;;+BAQpE,qBAAqB,WAClB,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;8BAezB,qBAAqB,WAClB,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;iCA2BzB,qBAAqB,WAClB,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;;MAoCnC;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAycxE"}