n8n-nodes-beeper 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Queng123
+
+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,98 @@
+# n8n-nodes-beeper
+
+This is an n8n community node. It lets you use **Beeper** in your n8n workflows.
+
+[Beeper](https://beeper.com) is a unified messaging app that brings all your chat networks (iMessage, WhatsApp, Telegram, Instagram, Slack, Discord, and more) into a single inbox. This node connects to the Beeper Desktop API to automate your messaging workflows.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/sustainable-use-license/) workflow automation platform.
+
+[Installation](#installation)
+[Operations](#operations)
+[Credentials](#credentials)
+[Compatibility](#compatibility)
+[Usage](#usage)
+[Resources](#resources)
+[Version history](#version-history)
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+## Operations
+
+### Account
+- **List** - List all connected accounts (WhatsApp, Telegram, iMessage, etc.)
+
+### Chat
+- **List** - List all chats with optional limit
+- **Get** - Get details of a specific chat by ID
+- **Create** - Create a new chat with a recipient
+- **Search** - Search for chats by query
+- **Archive** - Archive or unarchive a chat
+
+### Message
+- **Send** - Send a message to a chat
+- **List** - List messages in a chat with optional limit
+- **Search** - Search for messages across all chats
+
+### Contact
+- **Search** - Search for contacts in a specific account
+
+## Credentials
+
+Before using this node, you need:
+
+1. **Beeper Desktop** version 4.1.169 or later installed
+2. **Beeper Desktop API** enabled:
+   - Open Beeper Desktop
+   - Go to **Settings > Developers**
+   - Toggle **Beeper Desktop API** to enable it
+
+To configure credentials in n8n:
+
+1. Go to **Settings > Credentials**
+2. Click **Add Credential**
+3. Search for **Beeper API**
+4. Configure:
+   - **Base URL**: `http://localhost:23373` (default)
+   - **API Token**: Use the one configured in Beeper
+5. Click **Test** to verify the connection
+
+## Compatibility
+
+- **n8n**: 1.0.0+
+- **Node.js**: 18.x+
+- **Beeper Desktop**: 4.1.169+
+
+## Usage
+
+### Sending a message
+
+1. Use **Chat > List** or **Chat > Search** to find the chat ID
+2. Use **Message > Send** with the chat ID and your message text
+
+### Finding a Chat ID
+
+Chat IDs in Beeper have the format `!roomid:beeper.local`. You can get them by:
+- Using the **Chat > List** operation
+- Using the **Chat > Search** operation with a query
+
+### Rate Limiting
+
+Sending too many messages may result in account suspension by the messaging networks. Add delays between messages and use this node for personal automation only.
+
+## Resources
+
+* [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+* [Beeper Website](https://beeper.com)
+* [Beeper Desktop API Documentation](https://developers.beeper.com/desktop-api)
+
+## Version history
+
+### 0.1.0
+
+Initial release with:
+- Account operations: List
+- Chat operations: List, Get, Create, Search, Archive
+- Message operations: Send, List, Search
+- Contact operations: Search

package/dist/credentials/BeeperApi.credentials.d.ts

@@ -0,0 +1,13 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class BeeperApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    icon: {
+        readonly light: "file:beeper.svg";
+        readonly dark: "file:beeper.dark.svg";
+    };
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/BeeperApi.credentials.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BeeperApi = void 0;
+class BeeperApi {
+    constructor() {
+        this.name = 'beeperApi';
+        this.displayName = 'Beeper API';
+        this.documentationUrl = 'https://developers.beeper.com/desktop-api';
+        this.icon = { light: 'file:beeper.svg', dark: 'file:beeper.dark.svg' };
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'http://localhost:23373',
+                placeholder: 'http://localhost:23373',
+                description: 'The base URL of your Beeper Desktop API',
+            },
+            {
+                displayName: 'API Token',
+                name: 'apiToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                description: 'The API token for authentication (if required)',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '={{"Bearer " + $credentials.apiToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/v1/accounts',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.BeeperApi = BeeperApi;
+//# sourceMappingURL=BeeperApi.credentials.js.map

package/dist/credentials/BeeperApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeeperApi.credentials.js","sourceRoot":"","sources":["../../credentials/BeeperApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,SAAS;IAAtB;QACC,SAAI,GAAG,WAAW,CAAC;QACnB,gBAAW,GAAG,YAAY,CAAC;QAC3B,qBAAgB,GAAG,2CAA2C,CAAC;QAC/D,SAAI,GAAG,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,sBAAsB,EAAW,CAAC;QAC3E,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,wBAAwB;gBACjC,WAAW,EAAE,wBAAwB;gBACrC,WAAW,EAAE,yCAAyC;aACtD;YACD;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,gDAAgD;aAC7D;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,wCAAwC;iBACvD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,cAAc;gBACnB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AA1CD,8BA0CC"}

package/dist/credentials/beeper.dark.svg

@@ -0,0 +1,104 @@
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="100%" viewBox="0 0 1024 1024" enable-background="new 0 0 1024 1024" xml:space="preserve">
+<path fill="#000000" opacity="1.000000" stroke="none" 
+	d="
+M475.000000,1025.000000 
+	C316.666656,1025.000000 158.833328,1025.000000 1.000000,1025.000000 
+	C1.000000,683.666687 1.000000,342.333344 1.000000,1.000000 
+	C342.333344,1.000000 683.666687,1.000000 1025.000000,1.000000 
+	C1025.000000,342.333344 1025.000000,683.666687 1025.000000,1025.000000 
+	C841.833313,1025.000000 658.666687,1025.000000 475.000000,1025.000000 
+M368.997162,734.500000 
+	C368.997162,742.590881 368.997162,750.681702 368.997162,759.002808 
+	C371.192474,759.002808 372.675964,759.000977 374.159424,759.003113 
+	C412.485382,759.058777 450.811310,759.111206 489.137268,759.173584 
+	C497.301331,759.186829 505.465790,759.194092 513.629333,759.277893 
+	C539.417847,759.542419 565.253662,760.483154 590.809265,755.923462 
+	C625.960083,749.651917 654.482056,732.843506 674.382568,702.575256 
+	C690.697693,677.760254 696.755920,650.544434 692.757141,621.257385 
+	C688.413452,589.444092 670.738159,565.542480 646.390015,545.946350 
+	C639.596436,540.478760 632.443787,535.457458 625.453918,530.229980 
+	C632.256287,523.262817 638.879150,516.731873 645.210693,509.929718 
+	C652.885498,501.684387 661.386963,493.938751 667.660095,484.705902 
+	C692.375061,448.330231 700.995361,408.463074 688.986694,365.620728 
+	C676.264282,320.231781 646.406982,289.986298 602.760010,273.160645 
+	C583.566650,265.761749 563.344360,263.609711 542.940369,263.547974 
+	C510.285004,263.449127 477.628052,263.649841 444.972870,263.879578 
+	C437.502899,263.932098 429.976959,264.146759 422.580353,265.094910 
+	C391.295532,269.105072 364.041901,281.807617 341.393951,303.920441 
+	C318.294312,326.474304 304.741852,353.886292 301.335724,385.947449 
+	C300.058258,397.972107 299.309174,410.323029 300.578125,422.285614 
+	C302.553284,440.906158 308.952301,458.452759 318.810760,474.536407 
+	C329.522430,492.012054 342.254669,507.585968 360.582184,517.696960 
+	C365.218353,520.254700 368.583008,523.800659 368.975311,529.209351 
+	C369.417389,535.304749 369.479980,541.437988 369.468201,547.554321 
+	C369.409485,578.042725 369.249298,608.530884 369.168610,639.019226 
+	C369.085236,670.512756 369.052216,702.006409 368.997162,734.500000 
+z"/>
+<path fill="#3552F3" opacity="1.000000" stroke="none" 
+	d="
+M368.997162,734.000000 
+	C369.052216,702.006409 369.085236,670.512756 369.168610,639.019226 
+	C369.249298,608.530884 369.409485,578.042725 369.468201,547.554321 
+	C369.479980,541.437988 369.417389,535.304749 368.975311,529.209351 
+	C368.583008,523.800659 365.218353,520.254700 360.582184,517.696960 
+	C342.254669,507.585968 329.522430,492.012054 318.810760,474.536407 
+	C308.952301,458.452759 302.553284,440.906158 300.578125,422.285614 
+	C299.309174,410.323029 300.058258,397.972107 301.335724,385.947449 
+	C304.741852,353.886292 318.294312,326.474304 341.393951,303.920441 
+	C364.041901,281.807617 391.295532,269.105072 422.580353,265.094910 
+	C429.976959,264.146759 437.502899,263.932098 444.972870,263.879578 
+	C477.628052,263.649841 510.285004,263.449127 542.940369,263.547974 
+	C563.344360,263.609711 583.566650,265.761749 602.760010,273.160645 
+	C646.406982,289.986298 676.264282,320.231781 688.986694,365.620728 
+	C700.995361,408.463074 692.375061,448.330231 667.660095,484.705902 
+	C661.386963,493.938751 652.885498,501.684387 645.210693,509.929718 
+	C638.879150,516.731873 632.256287,523.262817 625.453918,530.229980 
+	C632.443787,535.457458 639.596436,540.478760 646.390015,545.946350 
+	C670.738159,565.542480 688.413452,589.444092 692.757141,621.257385 
+	C696.755920,650.544434 690.697693,677.760254 674.382568,702.575256 
+	C654.482056,732.843506 625.960083,749.651917 590.809265,755.923462 
+	C565.253662,760.483154 539.417847,759.542419 513.629333,759.277893 
+	C505.465790,759.194092 497.301331,759.186829 489.137268,759.173584 
+	C450.811310,759.111206 412.485382,759.058777 374.159424,759.003113 
+	C372.675964,759.000977 371.192474,759.002808 368.997162,759.002808 
+	C368.997162,750.681702 368.997162,742.590881 368.997162,734.000000 
+M654.676025,390.114624 
+	C654.502197,389.302917 654.290710,388.497253 654.159851,387.678711 
+	C649.211182,356.727417 633.215942,333.331940 606.283203,317.298859 
+	C589.488892,307.301208 571.015259,303.384247 551.872681,303.129822 
+	C515.215088,302.642609 478.547607,302.854889 441.884338,302.888123 
+	C436.739624,302.892792 431.563446,303.268707 426.456177,303.907532 
+	C385.932465,308.976044 358.379639,331.683594 344.255310,368.970703 
+	C324.481140,421.173004 351.424408,483.205963 412.731750,500.576965 
+	C428.544586,505.057465 444.737030,504.130402 460.872803,504.094543 
+	C469.473999,504.075409 478.075287,504.091125 486.750977,504.091125 
+	C485.225647,511.851044 483.811401,519.194092 482.336212,526.524780 
+	C475.608398,559.957581 468.825806,593.379456 462.184845,626.829468 
+	C461.543915,630.057800 461.742950,633.452881 461.488159,637.881042 
+	C463.237305,636.520691 463.787476,636.177490 464.235931,635.731995 
+	C517.078857,583.239929 569.985535,530.811646 622.694214,478.185150 
+	C634.270508,466.626923 643.966309,453.655914 649.331421,437.810547 
+	C654.497314,422.553528 655.710693,406.935181 654.676025,390.114624 
+z"/>
+<path fill="#000000" opacity="1.000000" stroke="none" 
+	d="
+M654.737549,390.566986 
+	C655.710693,406.935181 654.497314,422.553528 649.331421,437.810547 
+	C643.966309,453.655914 634.270508,466.626923 622.694214,478.185150 
+	C569.985535,530.811646 517.078857,583.239929 464.235931,635.731995 
+	C463.787476,636.177490 463.237305,636.520691 461.488159,637.881042 
+	C461.742950,633.452881 461.543915,630.057800 462.184845,626.829468 
+	C468.825806,593.379456 475.608398,559.957581 482.336212,526.524780 
+	C483.811401,519.194092 485.225647,511.851044 486.750977,504.091125 
+	C478.075287,504.091125 469.473999,504.075409 460.872803,504.094543 
+	C444.737030,504.130402 428.544586,505.057465 412.731750,500.576965 
+	C351.424408,483.205963 324.481140,421.173004 344.255310,368.970703 
+	C358.379639,331.683594 385.932465,308.976044 426.456177,303.907532 
+	C431.563446,303.268707 436.739624,302.892792 441.884338,302.888123 
+	C478.547607,302.854889 515.215088,302.642609 551.872681,303.129822 
+	C571.015259,303.384247 589.488892,307.301208 606.283203,317.298859 
+	C633.215942,333.331940 649.211182,356.727417 654.159851,387.678711 
+	C654.290710,388.497253 654.502197,389.302917 654.737549,390.566986 
+z"/>
+</svg>