n8n-nodes-imessage 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Photon
+
+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,116 @@
+# n8n-nodes-imessage
+
+[![npm version](https://img.shields.io/npm/v/n8n-nodes-imessage.svg)](https://www.npmjs.com/package/n8n-nodes-imessage)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+This is an n8n community node for [Photon iMessage](https://github.com/photon-hq/advanced-imessage-kit). It lets you send, receive, search, and automate iMessage conversations directly from your n8n workflows.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+## Prerequisites
+
+You need a running **Photon iMessage server** on a Mac. The server exposes a REST API that this node communicates with over HTTP.
+
+- Install and run the [advanced-imessage-kit](https://github.com/photon-hq/advanced-imessage-kit) server on your Mac
+- Note your **Server URL** (e.g. `https://your-server.example.com`) and **API Key**
+
+## Installation
+
+Follow the [n8n community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) to install `n8n-nodes-imessage` in your n8n instance.
+
+```
+npm install n8n-nodes-imessage
+```
+
+## Credentials
+
+1. In n8n, go to **Credentials** and create a new **Photon iMessage API** credential
+2. Enter your **Server URL** — the base URL of your Photon server (no trailing slash)
+3. Enter your **API Key** — the key is sent as an `X-API-Key` header on every request
+4. Click **Test** to verify the connection (calls `GET /api/v1/server/info`)
+
+## Nodes
+
+### Photon iMessage (Action Node)
+
+Perform operations on your iMessage account.
+
+#### Message
+
+| Operation | Description |
+|-----------|-------------|
+| **Send Message** | Send a text message to a chat. Supports reply-to, message effects (confetti, fireworks, etc.), and subject lines. |
+| **Send Attachment** | Send a file from the server Mac to a chat. Supports voice messages. |
+| **Unsend Message** | Retract a sent message. |
+| **Edit Message** | Edit the text of a sent message. |
+| **React to Message** | Send a tapback reaction (love, like, dislike, laugh, emphasize, question). |
+| **Download Attachment** | Download a received file or media attachment. |
+| **Search Messages** | Search messages by text content across all chats or a specific chat. |
+| **Get Messages** | Retrieve messages from a chat with date range and sort options. |
+
+#### Chat
+
+| Operation | Description |
+|-----------|-------------|
+| **List Chats** | List all conversations with optional last message preview. |
+| **Create Chat** | Start a new conversation with one or more participants. |
+| **Mark Chat Read** | Mark all messages in a chat as read. |
+| **Start Typing** | Show the typing indicator in a chat. |
+| **Stop Typing** | Hide the typing indicator in a chat. |
+
+#### Contact
+
+| Operation | Description |
+|-----------|-------------|
+| **Share Contact Card** | Share your Name and Photo contact card in a chat. |
+
+#### Poll
+
+| Operation | Description |
+|-----------|-------------|
+| **Create Poll** | Create an interactive poll in a chat. |
+| **Vote** | Vote on a poll option. |
+| **Unvote** | Remove your vote from a poll option. |
+| **Add Option** | Add a new option to an existing poll. |
+
+#### Scheduled Message
+
+| Operation | Description |
+|-----------|-------------|
+| **Create Scheduled Message** | Schedule a message to send later. Supports one-time and recurring schedules (hourly, daily, weekly, monthly, yearly). |
+| **List Scheduled Messages** | View all pending scheduled messages. |
+| **Delete Scheduled Message** | Remove a scheduled message. |
+
+#### Handle
+
+| Operation | Description |
+|-----------|-------------|
+| **Check iMessage Availability** | Check if a phone number or email address supports iMessage. |
+
+### Photon iMessage Trigger (Polling Trigger)
+
+Triggers your workflow when new iMessages are received.
+
+| Parameter | Description |
+|-----------|-------------|
+| **Chat GUID** | Only trigger for messages in a specific chat (leave blank for all). |
+| **Include Sent Messages** | Also trigger for messages you sent (default: off). |
+
+The trigger polls for new messages and tracks the last message timestamp to avoid duplicates.
+
+## Chat GUID Format
+
+The Chat GUID identifies a conversation:
+
+- **iMessage DM**: `iMessage;-;+1234567890` or `iMessage;-;email@example.com`
+- **SMS DM**: `SMS;-;+1234567890`
+- **Group chat**: `iMessage;+;chat123456789`
+
+## Resources
+
+- [Photon advanced-imessage-kit](https://github.com/photon-hq/advanced-imessage-kit) — The iMessage server SDK
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+[MIT](LICENSE)

package/dist/credentials/PhotonIMessageApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class PhotonIMessageApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/PhotonIMessageApi.credentials.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhotonIMessageApi = void 0;
+class PhotonIMessageApi {
+    constructor() {
+        this.name = 'photonIMessageApi';
+        this.displayName = 'Photon iMessage API';
+        this.documentationUrl = 'https://github.com/photon-hq/advanced-imessage-kit';
+        this.properties = [
+            {
+                displayName: 'Server URL',
+                name: 'serverUrl',
+                type: 'string',
+                default: 'http://localhost:1234',
+                placeholder: 'https://your-server.example.com',
+                description: 'Base URL of your Photon iMessage server (no trailing slash)',
+                required: true,
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'API key for authenticating with the Photon server',
+                required: true,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-API-Key': '={{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.serverUrl}}',
+                url: '/api/v1/server/info',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.PhotonIMessageApi = PhotonIMessageApi;
+//# sourceMappingURL=PhotonIMessageApi.credentials.js.map

package/dist/credentials/PhotonIMessageApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhotonIMessageApi.credentials.js","sourceRoot":"","sources":["../../credentials/PhotonIMessageApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,iBAAiB;IAA9B;QACC,SAAI,GAAG,mBAAmB,CAAC;QAC3B,gBAAW,GAAG,qBAAqB,CAAC;QACpC,qBAAgB,GAAG,oDAAoD,CAAC;QACxE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,WAAW,EAAE,iCAAiC;gBAC9C,WAAW,EAAE,6DAA6D;gBAC1E,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,mDAAmD;gBAChE,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,WAAW,EAAE,0BAA0B;iBACvC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,qBAAqB;gBAC1B,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAzCD,8CAyCC"}

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

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class PhotonIMessage implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}