n8n-nodes-42min 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 42min
+
+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,151 @@
+# n8n-nodes-42min
+
+An [n8n](https://n8n.io) community node for [42min](https://42min.us), a meeting
+scheduling platform. Create and manage bookings, look up availability, and start
+workflows the moment something happens on a calendar.
+
+This is a community node. It runs inside your own n8n instance and talks directly to
+`api.42min.us`; nothing routes through a third party.
+
+## Installation
+
+In n8n, go to **Settings → Community Nodes → Install** and enter:
+
+```
+n8n-nodes-42min
+```
+
+Or install it manually next to your n8n data directory:
+
+```bash
+npm install n8n-nodes-42min
+```
+
+Requires n8n 1.x and Node.js 20.15 or newer.
+
+## Credentials
+
+The node authenticates with a **personal access token**.
+
+1. In 42min, open **Settings → API** and create a token.
+2. Give it the scopes you need. For everything this node offers:
+   `user:read`, `event_types:read`, `slots:read`, `bookings:read`, `bookings:create`,
+   `bookings:cancel`, `bookings:reschedule`, `bookings:update`, `webhooks:read`,
+   `webhooks:write`.
+3. In n8n, create a **42min API** credential and paste the token.
+
+Use **Test** to confirm it works. Leave **Base URL** alone unless you run a
+self-hosted 42min.
+
+## Operations
+
+### 42min (action node)
+
+| Resource | Operations |
+|---|---|
+| **Booking** | Create, Get, Get Many, Update, Cancel, Reschedule |
+| **Event Type** | Get, Get Many |
+| **Slot** | Get Many, Check |
+| **User** | Get Current |
+
+### 42min Trigger
+
+Starts a workflow on any of these events:
+
+`booking_created`, `booking_updated`, `booking_canceled`, `booking_rescheduled`,
+`booking_no_show`, `event_type_updated`, `event_type_deleted`,
+`routing_form_submitted`.
+
+Activating a workflow registers a webhook subscription with 42min automatically, and
+deactivating it removes the subscription again.
+
+## Things worth knowing
+
+**Trigger items and lookup items use the same field names.** 42min delivers webhooks
+in nested camelCase (`data.booking.startTime`) while the REST API is flat snake_case
+(`start_at`). Booking triggers reshape the delivery into the REST vocabulary so you do
+not have to learn two names for every field. The original envelope fields survive as
+`event_id`, `event` and `occurred_at`. Set **Raw Payload** if you want the delivery
+untouched.
+
+**Deliveries are verified.** Every webhook is checked against its
+`X-42min-Webhook-Signature` HMAC, with a replay window, and anything that fails is
+rejected with a 401 instead of starting your workflow. Turn **Verify Signature** off
+only if something between 42min and n8n rewrites the request body.
+
+**Dedupe on `delivery_id`, not `event_id`.** The delivery id is stable across retries.
+Both are attached to every trigger item.
+
+**Writes are idempotent.** Booking creates, updates, cancels and reschedules send an
+`Idempotency-Key` derived from the execution and item, so a retry inside one execution
+replays the original result rather than double-booking. Set **Idempotency Key**
+yourself when the same logical operation might be attempted from more than one
+execution, for example keyed on a CRM record id.
+
+**Get Event Type identifies by ID or by username plus slug.** A slug alone is not
+enough, since it is unique per user rather than per account. The node encodes the
+`username/slug` pair into the single path segment the API expects.
+
+**Check the slot before you book.** Use **Slot: Check** first. A slot that was free a
+moment ago may not be, and Create Booking sends real email and writes to a real
+calendar.
+
+**Updating a booking reads it first.** 42min requires the `If-Match` version token on
+a PATCH, so the node fetches the booking, takes its ETag and sends it back. A
+concurrent edit fails with a 409 rather than being silently overwritten. Only
+`metadata`, `responses` and `attendee_name` are writable: to move a booking use
+**Reschedule**, to cancel it use **Cancel**.
+
+## Trigger requirements
+
+42min delivers over HTTPS to public addresses only. Your n8n must be:
+
+- reachable at an `https://` URL, and
+- resolvable to a public IP. Deliveries to private ranges are refused.
+
+If n8n advertises a non-HTTPS address the trigger will say so when you activate the
+workflow. Set `WEBHOOK_URL` (or `N8N_PROTOCOL` and `N8N_HOST`) accordingly.
+
+The action node has no such requirement: it only makes outbound calls, so it works
+behind a firewall.
+
+## Local development
+
+```bash
+npm install
+npm run lint
+npm test
+```
+
+To run n8n with the node loaded and rebuilt on every change:
+
+```bash
+npm run dev
+```
+
+For the trigger you need a publicly reachable n8n, so use a tunnel during
+development.
+
+## Releasing
+
+Publishing happens in GitHub Actions, which attaches an npm provenance
+statement. n8n requires this: nodes published from a local machine are not
+accepted for verification.
+
+```bash
+npm version minor
+git push --follow-tags
+```
+
+Pushing the tag runs `.github/workflows/publish.yml`, which lints, builds and
+publishes. Update `CHANGELOG.md` in the same commit as the version bump.
+
+## Resources
+
+- [42min API reference](https://42min.us/help/api)
+- [OpenAPI specification](https://api.42min.us/openapi.yaml)
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+[MIT](LICENSE)

package/dist/credentials/FortyTwoMinApi.credentials.d.ts

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

package/dist/credentials/FortyTwoMinApi.credentials.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FortyTwoMinApi = void 0;
+class FortyTwoMinApi {
+    constructor() {
+        this.name = 'fortyTwoMinApi';
+        this.displayName = '42min API';
+        this.icon = { light: 'file:../icons/fortytwomin.svg', dark: 'file:../icons/fortytwomin.dark.svg' };
+        this.documentationUrl = 'https://42min.us/help/api';
+        this.properties = [
+            {
+                displayName: 'Access Token',
+                name: 'accessToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Personal access token from 42min. Create one under Settings > API in your 42min account.',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.42min.us',
+                description: 'Change this only if you run a self-hosted 42min instance. Do not include a trailing slash or the /v1 path.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.accessToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/v1/me',
+            },
+        };
+    }
+}
+exports.FortyTwoMinApi = FortyTwoMinApi;
+//# sourceMappingURL=FortyTwoMinApi.credentials.js.map

package/dist/credentials/FortyTwoMinApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FortyTwoMinApi.credentials.js","sourceRoot":"","sources":["../../credentials/FortyTwoMinApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,cAAc;IAA3B;QACC,SAAI,GAAG,gBAAgB,CAAC;QAExB,gBAAW,GAAG,WAAW,CAAC;QAE1B,SAAI,GAAS,EAAE,KAAK,EAAE,+BAA+B,EAAE,IAAI,EAAE,oCAAoC,EAAE,CAAC;QAEpG,qBAAgB,GAAG,2BAA2B,CAAC;QAE/C,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EACV,6FAA6F;aAC9F;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,sBAAsB;gBAC/B,WAAW,EACV,4GAA4G;aAC7G;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,sCAAsC;iBACrD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,QAAQ;aACb;SACD,CAAC;IACH,CAAC;CAAA;AA7CD,wCA6CC"}

package/dist/icons/fortytwomin.dark.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" width="32" height="32">
+  <defs>
+    <clipPath id="fortytwomin-clip-dark">
+      <rect x="2" y="5" width="28" height="26" rx="3"></rect>
+    </clipPath>
+  </defs>
+
+  <rect x="8" y="1" width="2.5" height="5" rx="1.2" fill="#fdf6ec"></rect>
+  <rect x="21.5" y="1" width="2.5" height="5" rx="1.2" fill="#fdf6ec"></rect>
+
+  <rect x="2" y="5" width="28" height="26" rx="3" fill="#1a1625"></rect>
+
+  <g clip-path="url(#fortytwomin-clip-dark)">
+    <rect x="2" y="5" width="28" height="9" fill="#f25c2c"></rect>
+  </g>
+
+  <line x1="2" y1="14" x2="30" y2="14" stroke="#fdf6ec" stroke-width="1.6"></line>
+
+  <text x="16" y="27" text-anchor="middle" fill="#fdf6ec" font-family="Outfit, &#39;Trebuchet MS&#39;, sans-serif" font-size="14" font-weight="900" letter-spacing="-0.5">42</text>
+
+  <rect x="2" y="5" width="28" height="26" rx="3" fill="none" stroke="#fdf6ec" stroke-width="2"></rect>
+</svg>

package/dist/icons/fortytwomin.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" width="32" height="32">
+  <defs>
+    <clipPath id="fortytwomin-clip">
+      <rect x="2" y="5" width="28" height="26" rx="3"></rect>
+    </clipPath>
+  </defs>
+  
+  <rect x="8" y="1" width="2.5" height="5" rx="1.2" fill="#1a1625"></rect>
+  <rect x="21.5" y="1" width="2.5" height="5" rx="1.2" fill="#1a1625"></rect>
+  
+  <rect x="2" y="5" width="28" height="26" rx="3" fill="#fdf6ec"></rect>
+  
+  <g clip-path="url(#fortytwomin-clip)">
+    <rect x="2" y="5" width="28" height="9" fill="#f25c2c"></rect>
+  </g>
+  
+  <line x1="2" y1="14" x2="30" y2="14" stroke="#1a1625" stroke-width="1.6"></line>
+  
+  <text x="16" y="27" text-anchor="middle" fill="#1a1625" font-family="Outfit, &#39;Trebuchet MS&#39;, sans-serif" font-size="14" font-weight="900" letter-spacing="-0.5">42</text>
+  
+  <rect x="2" y="5" width="28" height="26" rx="3" fill="none" stroke="#1a1625" stroke-width="2"></rect>
+</svg>

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

@@ -0,0 +1,4 @@
+import type { INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class FortyTwoMin implements INodeType {
+    description: INodeTypeDescription;
+}

package/dist/nodes/FortyTwoMin/FortyTwoMin.node.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FortyTwoMin = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const BookingDescription_1 = require("./descriptions/BookingDescription");
+const EventTypeDescription_1 = require("./descriptions/EventTypeDescription");
+const SlotDescription_1 = require("./descriptions/SlotDescription");
+const UserDescription_1 = require("./descriptions/UserDescription");
+class FortyTwoMin {
+    constructor() {
+        this.description = {
+            displayName: '42min',
+            name: 'fortyTwoMin',
+            icon: { light: 'file:../../icons/fortytwomin.svg', dark: 'file:../../icons/fortytwomin.dark.svg' },
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Read and write bookings, event types and availability in 42min',
+            defaults: { name: '42min' },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [{ name: 'fortyTwoMinApi', required: true }],
+            requestDefaults: {
+                baseURL: '={{$credentials.baseUrl.replace(/\\/+$/, "")}}/v1',
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                },
+            },
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        { name: 'Booking', value: 'booking' },
+                        { name: 'Event Type', value: 'eventType' },
+                        { name: 'Slot', value: 'slot' },
+                        { name: 'User', value: 'user' },
+                    ],
+                    default: 'booking',
+                },
+                ...BookingDescription_1.bookingOperations,
+                ...BookingDescription_1.bookingFields,
+                ...EventTypeDescription_1.eventTypeOperations,
+                ...EventTypeDescription_1.eventTypeFields,
+                ...SlotDescription_1.slotOperations,
+                ...SlotDescription_1.slotFields,
+                ...UserDescription_1.userOperations,
+                ...UserDescription_1.userFields,
+                {
+                    displayName: 'Idempotency Key',
+                    name: 'idempotencyKey',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: { resource: ['booking'], operation: ['create', 'update', 'cancel', 'reschedule'] },
+                    },
+                    description: 'Leave empty to derive one from the execution and item. Set it to a stable value of your own, such as a CRM record ID, when the same logical operation may be attempted from more than one execution.',
+                },
+            ],
+        };
+    }
+}
+exports.FortyTwoMin = FortyTwoMin;
+//# sourceMappingURL=FortyTwoMin.node.js.map

package/dist/nodes/FortyTwoMin/FortyTwoMin.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FortyTwoMin.node.js","sourceRoot":"","sources":["../../../nodes/FortyTwoMin/FortyTwoMin.node.ts"],"names":[],"mappings":";;;AACA,+CAAmD;AAEnD,0EAAqF;AACrF,8EAA2F;AAC3F,oEAA4E;AAC5E,oEAA4E;AAE5E,MAAa,WAAW;IAAxB;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,OAAO;YACpB,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,IAAI,EAAE,uCAAuC,EAAE;YAClG,KAAK,EAAE,CAAC,WAAW,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,8DAA8D;YACxE,WAAW,EAAE,gEAAgE;YAC7E,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;YAC3B,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACzD,eAAe,EAAE;gBAChB,OAAO,EAAE,mDAAmD;gBAC5D,OAAO,EAAE;oBACR,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;iBAClC;aACD;YACD,UAAU,EAAE;gBACX;oBACC,WAAW,EAAE,UAAU;oBACvB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,SAAS;oBACf,gBAAgB,EAAE,IAAI;oBACtB,OAAO,EAAE;wBACR,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;wBACrC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE;wBAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;wBAC/B,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;qBAC/B;oBACD,OAAO,EAAE,SAAS;iBAClB;gBAED,GAAG,sCAAiB;gBACpB,GAAG,kCAAa;gBAChB,GAAG,0CAAmB;gBACtB,GAAG,sCAAe;gBAClB,GAAG,gCAAc;gBACjB,GAAG,4BAAU;gBACb,GAAG,gCAAc;gBACjB,GAAG,4BAAU;gBAEb;oBACC,WAAW,EAAE,iBAAiB;oBAC9B,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,EAAE;oBACX,cAAc,EAAE;wBACf,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE;qBACxF;oBACD,WAAW,EACV,sMAAsM;iBACvM;aACD;SACD,CAAC;IACH,CAAC;CAAA;AA1DD,kCA0DC"}

package/dist/nodes/FortyTwoMin/FortyTwoMin.node.json

@@ -0,0 +1,18 @@
+{
+	"node": "n8n-nodes-42min.fortyTwoMin",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Productivity", "Sales"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://42min.us/help/integrations/n8n"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://42min.us/help/api/overview"
+			}
+		]
+	}
+}

package/dist/nodes/FortyTwoMin/FortyTwoMinTrigger.node.d.ts

@@ -0,0 +1,12 @@
+import type { IHookFunctions, INodeType, INodeTypeDescription, IWebhookFunctions, IWebhookResponseData } from 'n8n-workflow';
+export declare class FortyTwoMinTrigger implements INodeType {
+    description: INodeTypeDescription;
+    webhookMethods: {
+        default: {
+            checkExists(this: IHookFunctions): Promise<boolean>;
+            create(this: IHookFunctions): Promise<boolean>;
+            delete(this: IHookFunctions): Promise<boolean>;
+        };
+    };
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+}

package/dist/nodes/FortyTwoMin/FortyTwoMinTrigger.node.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FortyTwoMinTrigger = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const GenericFunctions_1 = require("./GenericFunctions");
+class FortyTwoMinTrigger {
+    constructor() {
+        this.description = {
+            displayName: '42min Trigger',
+            name: 'fortyTwoMinTrigger',
+            icon: { light: 'file:../../icons/fortytwomin.svg', dark: 'file:../../icons/fortytwomin.dark.svg' },
+            group: ['trigger'],
+            version: 1,
+            subtitle: '={{$parameter["events"].join(", ")}}',
+            description: 'Starts a workflow when something happens in 42min',
+            defaults: { name: '42min Trigger' },
+            inputs: [],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [{ name: 'fortyTwoMinApi', required: true }],
+            webhooks: [
+                {
+                    name: 'default',
+                    httpMethod: 'POST',
+                    responseMode: 'onReceived',
+                    path: 'webhook',
+                    rawBody: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Events',
+                    name: 'events',
+                    type: 'multiOptions',
+                    required: true,
+                    default: ['booking_created'],
+                    description: 'The events to subscribe to',
+                    options: [
+                        { name: 'Booking Canceled', value: 'booking_canceled' },
+                        { name: 'Booking Created', value: 'booking_created' },
+                        { name: 'Booking Marked No-Show', value: 'booking_no_show' },
+                        { name: 'Booking Rescheduled', value: 'booking_rescheduled' },
+                        { name: 'Booking Updated', value: 'booking_updated' },
+                        { name: 'Event Type Deleted', value: 'event_type_deleted' },
+                        { name: 'Event Type Updated', value: 'event_type_updated' },
+                        { name: 'Routing Form Submitted', value: 'routing_form_submitted' },
+                    ],
+                },
+                {
+                    displayName: 'Options',
+                    name: 'options',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'Raw Payload',
+                            name: 'rawPayload',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to emit the delivery exactly as 42min sent it. By default booking events are reshaped into the same flat, snake_case field names the REST API uses, so a trigger item and a lookup item can be read the same way.',
+                        },
+                        {
+                            displayName: 'Timestamp Tolerance (Seconds)',
+                            name: 'tolerance',
+                            type: 'number',
+                            default: 300,
+                            typeOptions: { minValue: 0 },
+                            description: 'Reject deliveries whose signature timestamp is older than this. Guards against a captured delivery being replayed.',
+                        },
+                        {
+                            displayName: 'Verify Signature',
+                            name: 'verifySignature',
+                            type: 'boolean',
+                            default: true,
+                            description: 'Whether to check the X-42min-Webhook-Signature header and reject anything that fails. Turn this off only if your reverse proxy rewrites the request body.',
+                        },
+                    ],
+                },
+            ],
+        };
+        this.webhookMethods = {
+            default: {
+                async checkExists() {
+                    const staticData = this.getWorkflowStaticData('node');
+                    const webhookUrl = this.getNodeWebhookUrl('default');
+                    const response = await GenericFunctions_1.fortyTwoMinApiRequest.call(this, 'GET', '/v1/webhooks');
+                    const existing = (response.data ?? []).find((hook) => hook.url === webhookUrl);
+                    if (!existing) {
+                        delete staticData.webhookId;
+                        delete staticData.signingSecret;
+                        return false;
+                    }
+                    if (!staticData.signingSecret) {
+                        await GenericFunctions_1.fortyTwoMinApiRequest
+                            .call(this, 'DELETE', `/v1/webhooks/${existing.id}`)
+                            .catch(() => undefined);
+                        delete staticData.webhookId;
+                        return false;
+                    }
+                    staticData.webhookId = existing.id;
+                    return true;
+                },
+                async create() {
+                    const staticData = this.getWorkflowStaticData('node');
+                    const webhookUrl = this.getNodeWebhookUrl('default');
+                    const events = this.getNodeParameter('events');
+                    if (!webhookUrl?.startsWith('https://')) {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), '42min delivers webhooks over HTTPS only, and this n8n instance is reachable at a non-HTTPS URL', {
+                            description: 'Set WEBHOOK_URL (or N8N_PROTOCOL/N8N_HOST) so n8n advertises a public https:// address, then activate the workflow again. The address must also resolve to a public IP: 42min refuses to deliver to private ranges.',
+                        });
+                    }
+                    const response = await GenericFunctions_1.fortyTwoMinApiRequest.call(this, 'POST', '/v1/webhooks', {
+                        url: webhookUrl,
+                        events,
+                        description: `n8n: ${this.getWorkflow().name ?? 'workflow'}`,
+                    });
+                    const created = (response.data ?? {});
+                    if (!created.id || !created.signing_secret) {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), '42min did not return a subscription ID and signing secret');
+                    }
+                    staticData.webhookId = created.id;
+                    staticData.signingSecret = created.signing_secret;
+                    return true;
+                },
+                async delete() {
+                    const staticData = this.getWorkflowStaticData('node');
+                    if (!staticData.webhookId)
+                        return true;
+                    try {
+                        await GenericFunctions_1.fortyTwoMinApiRequest.call(this, 'DELETE', `/v1/webhooks/${staticData.webhookId}`);
+                    }
+                    catch (error) {
+                        const status = error?.httpCode ?? error?.statusCode;
+                        if (String(status) !== '404')
+                            return false;
+                    }
+                    delete staticData.webhookId;
+                    delete staticData.signingSecret;
+                    return true;
+                },
+            },
+        };
+    }
+    async webhook() {
+        const staticData = this.getWorkflowStaticData('node');
+        const options = this.getNodeParameter('options', {});
+        const headers = this.getHeaderData();
+        const request = this.getRequestObject();
+        const verify = options.verifySignature !== false;
+        const rawBody = request.rawBody;
+        if (verify) {
+            if (!rawBody) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'The raw request body was not available, so the webhook signature could not be verified', {
+                    description: 'Something between 42min and n8n is re-serializing the request. Fix the proxy, or turn off Verify Signature if you accept unauthenticated deliveries.',
+                });
+            }
+            const result = (0, GenericFunctions_1.verifyWebhookSignature)(rawBody, headers['x-42min-webhook-signature'], staticData.signingSecret ?? '', options.tolerance ?? 300);
+            if (!result.ok) {
+                const response = this.getResponseObject();
+                response.status(401).send(`Webhook signature rejected: ${result.reason}`);
+                return { noWebhookResponse: true };
+            }
+        }
+        let envelope;
+        if (rawBody) {
+            try {
+                envelope = JSON.parse(rawBody.toString('utf8'));
+            }
+            catch {
+                envelope = this.getBodyData();
+            }
+        }
+        else {
+            envelope = this.getBodyData();
+        }
+        const isBookingEvent = String(envelope.event ?? '').startsWith('booking.');
+        const emitRaw = options.rawPayload === true || !isBookingEvent;
+        const item = emitRaw ? envelope : (0, GenericFunctions_1.normalizeBookingEvent)(envelope);
+        item.delivery_id = headers['x-42min-webhook-id'] ?? null;
+        item.delivery_attempt = headers['x-42min-webhook-attempt'] ?? null;
+        return { workflowData: [this.helpers.returnJsonArray([item])] };
+    }
+}
+exports.FortyTwoMinTrigger = FortyTwoMinTrigger;
+//# sourceMappingURL=FortyTwoMinTrigger.node.js.map

package/dist/nodes/FortyTwoMin/FortyTwoMinTrigger.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FortyTwoMinTrigger.node.js","sourceRoot":"","sources":["../../../nodes/FortyTwoMin/FortyTwoMinTrigger.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/FortyTwoMin/FortyTwoMinTrigger.node.json

@@ -0,0 +1,18 @@
+{
+	"node": "n8n-nodes-42min.fortyTwoMinTrigger",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Productivity", "Sales"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://42min.us/help/integrations/n8n"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://42min.us/help/api/webhooks"
+			}
+		]
+	}
+}

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

@@ -0,0 +1,11 @@
+import type { IDataObject, IExecuteFunctions, IHookFunctions, IHttpRequestMethods, ILoadOptionsFunctions, IWebhookFunctions } from 'n8n-workflow';
+type RequestContext = IExecuteFunctions | IHookFunctions | ILoadOptionsFunctions | IWebhookFunctions;
+export declare function fortyTwoMinApiRequest(this: RequestContext, method: IHttpRequestMethods, resource: string, body?: IDataObject, qs?: IDataObject): Promise<IDataObject>;
+export declare function verifyWebhookSignature(rawBody: Buffer | string, signatureHeader: string | undefined, secret: string, toleranceSeconds?: number): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function normalizeBookingEvent(envelope: IDataObject): IDataObject;
+export {};