n8n-nodes-hostinger-mail 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Povilas Skrebutenas
+
+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,70 @@
+# n8n-nodes-hostinger-mail
+
+This is an [n8n](https://n8n.io/) community node package for the [Hostinger Email API](https://api.mail.hostinger.com/). It lets you send and manage email in your Hostinger mailboxes from n8n workflows, and trigger workflows when new mail arrives.
+
+The package contains two nodes:
+
+- **Hostinger Mail** — call the Hostinger Email API (send email, manage messages, folders and webhooks)
+- **Hostinger Mail Trigger** — start a workflow when a new email arrives in a mailbox (uses the API's `message.received` webhook)
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+In a self-hosted n8n instance: **Settings → Community Nodes → Install**, then enter `n8n-nodes-hostinger-mail`.
+
+## Credentials
+
+1. Generate an API token for Hostinger Email (in hPanel, under your email plan).
+2. In n8n, create new **Hostinger Mail API** credentials and paste the token.
+3. The credential test calls `GET /api/v1/me` to verify the token.
+
+The token is sent as a `Authorization: Bearer <token>` header on every request.
+
+## Hostinger Mail node
+
+| Resource | Operations |
+|----------|------------|
+| Account | Get (authenticated account and manageable mailboxes) |
+| Email | Send (text/HTML body, CC/BCC, attachments from binary data, inline images via Content-ID) |
+| Message | Get, Get Many, Search, Get Text, Get Source (.eml as binary), Download Attachment (binary), Move, Move Many, Update Flags, Update Flags Many, Delete, Delete Many, Delete All |
+| Folder | Get Many, Create, Update (rename), Delete |
+| Webhook | Get, Get Many, Create, Update, Delete, Regenerate Secret, Test |
+
+Mailboxes and folders are loaded dynamically into dropdowns from your account, and can also be set with expressions.
+
+## Hostinger Mail Trigger node
+
+Select a mailbox and activate the workflow. The node automatically:
+
+1. Registers a webhook for the `message.received` event pointing at your n8n webhook URL.
+2. Verifies each delivery using the webhook secret (sent by Hostinger as a bearer token).
+3. Removes the webhook when the workflow is deactivated.
+
+Your n8n instance must be reachable from the internet for deliveries to arrive (set `WEBHOOK_URL` if you are behind a proxy).
+
+## Development
+
+```bash
+npm install
+npm run dev     # run n8n locally with the node loaded
+npm run lint    # lint with the n8n community node rules
+npm run build   # build to dist/
+```
+
+## Publishing
+
+```bash
+npm run release
+```
+
+This bumps the version, tags, and pushes; the included GitHub Actions workflow (`.github/workflows/publish.yml`) publishes to npm. Alternatively run `npm publish` directly after `npm run build`.
+
+## Resources
+
+- [Hostinger Email API reference](https://api.mail.hostinger.com/)
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+[MIT](LICENSE)

package/dist/credentials/HostingerMailApi.credentials.d.ts

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

package/dist/credentials/HostingerMailApi.credentials.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HostingerMailApi = void 0;
+class HostingerMailApi {
+    constructor() {
+        this.name = 'hostingerMailApi';
+        this.displayName = 'Hostinger Mail API';
+        this.icon = 'file:../nodes/HostingerMail/hostingerMail.svg';
+        this.documentationUrl = 'https://api.mail.hostinger.com/';
+        this.properties = [
+            {
+                displayName: 'API Token',
+                name: 'apiToken',
+                type: 'string',
+                typeOptions: { password: true },
+                required: true,
+                default: '',
+                description: 'API token for the Hostinger Email API. Generate one in hPanel under Emails → Automation.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://api.mail.hostinger.com',
+                url: '/api/v1/me',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.HostingerMailApi = HostingerMailApi;
+//# sourceMappingURL=HostingerMailApi.credentials.js.map

package/dist/credentials/HostingerMailApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostingerMailApi.credentials.js","sourceRoot":"","sources":["../../credentials/HostingerMailApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,gBAAgB;IAA7B;QACC,SAAI,GAAG,kBAAkB,CAAC;QAE1B,gBAAW,GAAG,oBAAoB,CAAC;QAEnC,SAAI,GAAS,+CAA+C,CAAC;QAE7D,qBAAgB,GAAG,iCAAiC,CAAC;QAErD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EACV,0FAA0F;aAC3F;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,mCAAmC;iBAClD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,gCAAgC;gBACzC,GAAG,EAAE,YAAY;gBACjB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAtCD,4CAsCC"}

package/dist/nodes/HostingerMail/GenericFunctions.d.ts

@@ -0,0 +1,6 @@
+import type { IDataObject, IExecuteFunctions, IHookFunctions, IHttpRequestMethods, IHttpRequestOptions, ILoadOptionsFunctions, IWebhookFunctions } from 'n8n-workflow';
+export declare const BASE_URL = "https://api.mail.hostinger.com/api/v1";
+export declare function hostingerMailApiRequest(this: IExecuteFunctions | ILoadOptionsFunctions | IHookFunctions | IWebhookFunctions, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject, options?: Partial<IHttpRequestOptions>): Promise<any>;
+export declare function hostingerMailApiRequestAllItems(this: IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject, limit?: number): Promise<IDataObject[]>;
+export declare function parseStringList(value: string): string[];
+export declare function encodeFolderPath(folder: string): string;

package/dist/nodes/HostingerMail/GenericFunctions.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_URL = void 0;
+exports.hostingerMailApiRequest = hostingerMailApiRequest;
+exports.hostingerMailApiRequestAllItems = hostingerMailApiRequestAllItems;
+exports.parseStringList = parseStringList;
+exports.encodeFolderPath = encodeFolderPath;
+exports.BASE_URL = 'https://api.mail.hostinger.com/api/v1';
+async function hostingerMailApiRequest(method, endpoint, body = {}, qs = {}, options = {}) {
+    const requestOptions = {
+        method,
+        url: `${exports.BASE_URL}${endpoint}`,
+        qs,
+        body,
+        json: true,
+        ...options,
+    };
+    if (requestOptions.body !== undefined &&
+        typeof requestOptions.body === 'object' &&
+        requestOptions.body !== null &&
+        Object.keys(requestOptions.body).length === 0) {
+        delete requestOptions.body;
+    }
+    return await this.helpers.httpRequestWithAuthentication.call(this, 'hostingerMailApi', requestOptions);
+}
+async function hostingerMailApiRequestAllItems(method, endpoint, body = {}, qs = {}, limit) {
+    var _a;
+    const returnData = [];
+    let page = 1;
+    const perPage = limit !== undefined && limit < 100 ? limit : 100;
+    let responseData;
+    do {
+        responseData = (await hostingerMailApiRequest.call(this, method, endpoint, body, {
+            ...qs,
+            page,
+            perPage,
+        }));
+        returnData.push(...((_a = responseData.data) !== null && _a !== void 0 ? _a : []));
+        if (limit !== undefined && returnData.length >= limit) {
+            return returnData.slice(0, limit);
+        }
+        page++;
+    } while (responseData.pagination !== undefined &&
+        page <= responseData.pagination.totalPages);
+    return returnData;
+}
+function parseStringList(value) {
+    return value
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry !== '');
+}
+function encodeFolderPath(folder) {
+    return encodeURIComponent(folder);
+}
+//# sourceMappingURL=GenericFunctions.js.map

package/dist/nodes/HostingerMail/GenericFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenericFunctions.js","sourceRoot":"","sources":["../../../nodes/HostingerMail/GenericFunctions.ts"],"names":[],"mappings":";;;AAYA,0DAgCC;AAED,0EAiCC;AAED,0CAKC;AAED,4CAEC;AAhFY,QAAA,QAAQ,GAAG,uCAAuC,CAAC;AAEzD,KAAK,UAAU,uBAAuB,CAE5C,MAA2B,EAC3B,QAAgB,EAChB,OAAoB,EAAE,EACtB,KAAkB,EAAE,EACpB,UAAwC,EAAE;IAG1C,MAAM,cAAc,GAAwB;QAC3C,MAAM;QACN,GAAG,EAAE,GAAG,gBAAQ,GAAG,QAAQ,EAAE;QAC7B,EAAE;QACF,IAAI;QACJ,IAAI,EAAE,IAAI;QACV,GAAG,OAAO;KACV,CAAC;IAEF,IACC,cAAc,CAAC,IAAI,KAAK,SAAS;QACjC,OAAO,cAAc,CAAC,IAAI,KAAK,QAAQ;QACvC,cAAc,CAAC,IAAI,KAAK,IAAI;QAC5B,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAmB,CAAC,CAAC,MAAM,KAAK,CAAC,EAC3D,CAAC;QACF,OAAO,cAAc,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,IAAI,CAC3D,IAAI,EACJ,kBAAkB,EAClB,cAAc,CACd,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,+BAA+B,CAEpD,MAA2B,EAC3B,QAAgB,EAChB,OAAoB,EAAE,EACtB,KAAkB,EAAE,EACpB,KAAc;;IAEd,MAAM,UAAU,GAAkB,EAAE,CAAC;IACrC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAEjE,IAAI,YAAyB,CAAC;IAC9B,GAAG,CAAC;QACH,YAAY,GAAG,CAAC,MAAM,uBAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;YAChF,GAAG,EAAE;YACL,IAAI;YACJ,OAAO;SACP,CAAC,CAAgB,CAAC;QAEnB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAC,YAAY,CAAC,IAAsB,mCAAI,EAAE,CAAC,CAAC,CAAC;QAEjE,IAAI,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YACvD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,EAAE,CAAC;IACR,CAAC,QACA,YAAY,CAAC,UAAU,KAAK,SAAS;QACrC,IAAI,IAAM,YAAY,CAAC,UAA0B,CAAC,UAAqB,EACtE;IAEF,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,SAAgB,eAAe,CAAC,KAAa;IAC5C,OAAO,KAAK;SACV,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,gBAAgB,CAAC,MAAc;IAC9C,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class HostingerMail implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getMailboxes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getFolders(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}