@bauer-group/n8n-nodes-http-throttled-request 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) BAUER GROUP
+
+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,272 @@
+# n8n-nodes-http-throttled-request
+
+A custom n8n node that extends the HTTP Request functionality with intelligent rate-limit throttling. The node automatically detects rate-limit responses (429 Too Many Requests, etc.) and waits the appropriate time before retrying, using information from response headers.
+
+## Features
+
+- **Automatic Rate Limit Detection**: Detects HTTP 429, 503, and 504 status codes
+- **Smart Wait Time Calculation**: Parses `Retry-After`, `X-RateLimit-*`, and HubSpot-specific headers
+- **Jitter Support**: Prevents thundering herd with configurable random variance
+- **n8n v2 Compatible**: Uses modern `this.helpers.httpRequest()` API
+- **Shadow-Override Ready**: Can replace the core HTTP Request node transparently
+- **Full Authentication Support**: None, Basic Auth, Header Auth, OAuth1, OAuth2
+
+## Installation
+
+### Prerequisites
+
+- Node.js 20+
+- npm 9+
+- n8n instance (self-hosted)
+
+### Install from npm
+
+```bash
+npm install n8n-nodes-http-throttled-request
+```
+
+### Install from source
+
+1. Clone or download this repository
+2. Build the package:
+
+```bash
+npm install
+npm run build
+```
+
+3. Link to your n8n installation:
+
+```bash
+# Navigate to your n8n custom nodes directory
+cd ~/.n8n/nodes
+
+# Link the package
+npm link n8n-nodes-http-throttled-request
+```
+
+4. Restart your n8n instance
+
+### Docker Installation
+
+Mount the node package into your n8n container:
+
+```yaml
+# docker-compose.yml
+services:
+  n8n:
+    image: n8nio/n8n
+    volumes:
+      - ./n8n-nodes-http-throttled-request:/home/node/.n8n/nodes/n8n-nodes-http-throttled-request
+    environment:
+      - N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/nodes
+```
+
+## Configuration
+
+### Node Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| **Method** | Options | GET | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) |
+| **URL** | String | - | Target URL for the request |
+| **Authentication** | Options | None | Authentication type |
+| **Send Headers** | Boolean | false | Enable custom headers |
+| **Send Body** | Boolean | false | Enable request body |
+| **Throttling aktivieren** | Boolean | true | Enable automatic rate-limit handling |
+
+### Throttling Settings
+
+When throttling is enabled, additional options become available:
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| **HTTP-Codes** | Multi-select | 429 | Status codes that trigger throttling (429, 503, 504) |
+| **Standard-Wartezeit (ms)** | Number | 10000 | Default wait time when no header provides guidance |
+| **Zufaellige Abweichung (+/-%)** | Number | 25 | Jitter percentage to prevent thundering herd |
+| **Max. Throttle-Versuche** | Number | 10 | Maximum retry attempts before failing |
+
+### Authentication Types
+
+The node supports the following authentication methods:
+
+- **None**: No authentication
+- **Basic Auth**: HTTP Basic Authentication (username/password)
+- **Header Auth**: Custom header-based authentication
+- **OAuth1**: OAuth 1.0 authentication
+- **OAuth2**: OAuth 2.0 authentication
+
+## Usage Examples
+
+### Basic GET Request with Throttling
+
+1. Add the "HTTP Request" node to your workflow
+2. Set the URL to your API endpoint
+3. Enable "Throttling aktivieren" (enabled by default)
+4. Configure throttling settings as needed
+5. Execute the workflow
+
+### POST Request with JSON Body
+
+1. Add the HTTP Request node
+2. Set Method to "POST"
+3. Enter the target URL
+4. Enable "Send Body"
+5. Select "JSON" as Body Content Type
+6. Enter your JSON payload in the Body field
+
+### API Request with Rate Limit Handling
+
+For APIs that enforce rate limits (e.g., HubSpot, GitHub, Stripe):
+
+1. Enable throttling with appropriate HTTP codes (429, 503)
+2. Set a reasonable default wait time (e.g., 10000ms)
+3. Configure max retries based on your workflow timeout
+4. Add jitter (25%) to distribute retry attempts
+
+## How It Works
+
+### Rate Limit Detection
+
+When the node receives a response with a configured throttle status code (429, 503, or 504), it:
+
+1. Extracts wait time from response headers
+2. Applies jitter to prevent thundering herd
+3. Waits the calculated time
+4. Retries the request
+5. Repeats until success or max retries reached
+
+### Header Priority
+
+The node calculates wait time using this priority:
+
+1. **Retry-After** (highest priority)
+   - Seconds format: `Retry-After: 30`
+   - HTTP-Date format: `Retry-After: Wed, 19 Feb 2025 12:00:00 GMT`
+
+2. **Rate Limit with Remaining=0**
+   - `X-RateLimit-Remaining: 0` combined with reset timestamp
+
+3. **Reset Timestamp alone**
+   - `X-RateLimit-Reset: 1739966400`
+
+4. **Default fallback** (lowest priority)
+   - Uses configured default wait time
+
+### Supported Headers
+
+| Header | Format | Example |
+|--------|--------|---------|
+| `Retry-After` | Seconds or HTTP-Date | `30` or `Wed, 19 Feb 2025 12:00:00 GMT` |
+| `X-RateLimit-Reset` | Unix timestamp | `1739966400` |
+| `X-RateLimit-Remaining` | Integer | `0` |
+| `X-HubSpot-RateLimit-Reset` | Unix timestamp | `1739966400` |
+| `X-HubSpot-RateLimit-Remaining` | Integer | `0` |
+| `RateLimit-Reset` | Unix timestamp | `1739966400` |
+| `RateLimit-Remaining` | Integer | `0` |
+
+### Timestamp Detection
+
+The node automatically detects timestamp format:
+- Values > 10^12: Treated as milliseconds
+- Values > 10^9: Treated as seconds (Unix timestamp)
+
+### Safety Limits
+
+- **Maximum wait time**: 5 minutes (300,000ms)
+- **Jitter range**: 0-100%
+- **Minimum jitter result**: 0ms (never negative)
+
+## Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Test
+
+```bash
+npm test
+```
+
+### Test with Coverage
+
+```bash
+npm test -- --coverage
+```
+
+### Project Structure
+
+```
+n8n-nodes-http-throttled-request/
+├── package.json              # Package configuration
+├── tsconfig.json             # TypeScript configuration
+├── README.md                 # This file
+├── nodes/
+│   └── HttpRequest/
+│       ├── HttpRequestThrottled.node.ts  # Main node class
+│       └── throttling.ts                  # Throttling logic
+└── test/
+    └── throttling.test.ts    # Unit tests
+```
+
+## Troubleshooting
+
+### Node not appearing in n8n
+
+1. Verify the package is installed in the correct location
+2. Check n8n logs for loading errors
+3. Ensure `npm run build` completed successfully
+4. Restart n8n after installation
+
+### Throttling not working
+
+1. Verify "Throttling aktivieren" is enabled
+2. Check that the API returns one of the configured HTTP codes
+3. Review n8n execution logs for throttling messages
+
+### Maximum retries exceeded
+
+If you see "Maximale Anzahl Versuche erreicht":
+1. Increase "Max. Throttle-Versuche" setting
+2. Increase "Standard-Wartezeit" to wait longer between retries
+3. Check if the API requires authentication or has other restrictions
+
+## API Reference
+
+### Throttling Module Exports
+
+```typescript
+// Maximum wait time cap (5 minutes)
+export const MAX_THROTTLE_WAIT_MS = 300_000;
+
+// Normalize headers to lowercase keys
+export function normalizeHeaders(raw: Record<string, unknown>): Record<string, string>;
+
+// Parse Retry-After header to milliseconds
+export function parseRetryAfterToMs(v: string): number | null;
+
+// Parse reset timestamp headers to wait milliseconds
+export function parseResetToWaitMs(h: Record<string, string>): number | null;
+
+// Compute wait time from response headers
+export function computeWaitMs(rawHeaders: Record<string, unknown>, defaultWaitMs: number): number;
+
+// Apply jitter to wait time
+export function applyJitter(baseMs: number, jitterPct: number): number;
+```
+
+## License
+
+MIT
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run tests: `npm test`
+5. Submit a pull request
+

package/dist/nodes/HttpRequest/HttpRequestThrottled.node.d.ts

@@ -0,0 +1,6 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from "n8n-workflow";
+export declare class HttpRequestThrottled implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=HttpRequestThrottled.node.d.ts.map

package/dist/nodes/HttpRequest/HttpRequestThrottled.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpRequestThrottled.node.d.ts","sourceRoot":"","sources":["../../../src/nodes/HttpRequest/HttpRequestThrottled.node.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EAKrB,MAAM,cAAc,CAAC;AAWtB,qBAAa,oBAAqB,YAAW,SAAS;IACpD,WAAW,EAAE,oBAAoB,CAuL/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAyMxE"}

package/dist/nodes/HttpRequest/HttpRequestThrottled.node.js

@@ -0,0 +1,317 @@
+"use strict";
+// nodes/HttpRequest/HttpRequestThrottled.node.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpRequestThrottled = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const throttling_1 = require("./throttling");
+// ── Hilfsfunktion ─────────────────────────────────────────────────────────────
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// ── Node-Klasse ───────────────────────────────────────────────────────────────
+class HttpRequestThrottled {
+    constructor() {
+        this.description = {
+            // Exakten Wert aus Core Node V3 übernommen
+            name: "httpRequest",
+            displayName: "HTTP Request",
+            icon: "fa:at",
+            group: ["output"],
+            // v2: Versioned nodes – Array erlaubt mehrere Versionen gleichzeitig
+            version: [1, 2, 3],
+            defaultVersion: 3,
+            subtitle: '={{$parameter["method"] + ": " + $parameter["url"]}}',
+            description: "Makes an HTTP request and returns the response data (with throttling support)",
+            defaults: { name: "HTTP Request", color: "#2200DD" },
+            // Kompatibel mit n8n v1/v2: String-Literal 'main'
+            inputs: ["main"],
+            outputs: ["main"],
+            credentials: [
+                {
+                    name: "httpBasicAuth",
+                    required: false,
+                    displayOptions: { show: { authentication: ["basicAuth"] } },
+                },
+                {
+                    name: "httpHeaderAuth",
+                    required: false,
+                    displayOptions: { show: { authentication: ["headerAuth"] } },
+                },
+                {
+                    name: "oAuth1Api",
+                    required: false,
+                    displayOptions: { show: { authentication: ["oAuth1"] } },
+                },
+                {
+                    name: "oAuth2Api",
+                    required: false,
+                    displayOptions: { show: { authentication: ["oAuth2"] } },
+                },
+            ],
+            properties: [
+                // ── Kern-Properties (minimal, für Shadow-Override vollständig aus Core übernehmen) ──
+                {
+                    displayName: "Method",
+                    name: "method",
+                    type: "options",
+                    options: [
+                        { name: "DELETE", value: "DELETE" },
+                        { name: "GET", value: "GET" },
+                        { name: "HEAD", value: "HEAD" },
+                        { name: "OPTIONS", value: "OPTIONS" },
+                        { name: "PATCH", value: "PATCH" },
+                        { name: "POST", value: "POST" },
+                        { name: "PUT", value: "PUT" },
+                    ],
+                    default: "GET",
+                },
+                {
+                    displayName: "URL",
+                    name: "url",
+                    type: "string",
+                    default: "",
+                    placeholder: "https://example.com",
+                    required: true,
+                },
+                {
+                    displayName: "Authentication",
+                    name: "authentication",
+                    type: "options",
+                    options: [
+                        { name: "None", value: "none" },
+                        { name: "Basic Auth", value: "basicAuth" },
+                        { name: "Header Auth", value: "headerAuth" },
+                        { name: "OAuth1", value: "oAuth1" },
+                        { name: "OAuth2", value: "oAuth2" },
+                    ],
+                    default: "none",
+                },
+                {
+                    displayName: "Send Headers",
+                    name: "sendHeaders",
+                    type: "boolean",
+                    default: false,
+                },
+                {
+                    displayName: "Header Parameters",
+                    name: "headerParameters",
+                    type: "fixedCollection",
+                    typeOptions: { multipleValues: true },
+                    default: { parameters: [] },
+                    displayOptions: { show: { sendHeaders: [true] } },
+                    options: [
+                        {
+                            name: "parameters",
+                            displayName: "Header",
+                            values: [
+                                { displayName: "Name", name: "name", type: "string", default: "" },
+                                { displayName: "Value", name: "value", type: "string", default: "" },
+                            ],
+                        },
+                    ],
+                },
+                {
+                    displayName: "Send Body",
+                    name: "sendBody",
+                    type: "boolean",
+                    default: false,
+                },
+                {
+                    displayName: "Body Content Type",
+                    name: "contentType",
+                    type: "options",
+                    displayOptions: { show: { sendBody: [true] } },
+                    options: [
+                        { name: "JSON", value: "json" },
+                        { name: "Form Urlencoded", value: "form-urlencoded" },
+                        { name: "Raw", value: "raw" },
+                    ],
+                    default: "json",
+                },
+                {
+                    displayName: "Body",
+                    name: "body",
+                    type: "string",
+                    displayOptions: { show: { sendBody: [true] } },
+                    default: "",
+                    typeOptions: { rows: 4 },
+                },
+                // ── Throttling-Erweiterung ────────────────────────────────────────────────
+                {
+                    displayName: "Throttling aktivieren",
+                    name: "throttlingEnabled",
+                    type: "boolean",
+                    default: true,
+                    description: "Wartet automatisch bei Rate-Limit-Antworten (429 etc.) und wertet Response-Header aus",
+                    noDataExpression: true,
+                },
+                {
+                    displayName: "Throttling-Einstellungen",
+                    name: "throttling",
+                    type: "collection",
+                    placeholder: "Einstellung hinzufügen",
+                    default: {},
+                    displayOptions: { show: { throttlingEnabled: [true] } },
+                    options: [
+                        {
+                            displayName: "HTTP-Codes",
+                            name: "throttleCodes",
+                            type: "multiOptions",
+                            default: ["429"],
+                            description: "Bei diesen HTTP-Statuscodes wird Throttling ausgelöst",
+                            options: [
+                                { name: "429 Too Many Requests", value: "429" },
+                                { name: "503 Service Unavailable", value: "503" },
+                                { name: "504 Gateway Timeout", value: "504" },
+                            ],
+                        },
+                        {
+                            displayName: "Standard-Wartezeit (ms)",
+                            name: "defaultWaitMs",
+                            type: "number",
+                            default: 10000,
+                            description: "Wartezeit in Millisekunden, wenn kein passender Response-Header vorhanden ist",
+                        },
+                        {
+                            displayName: "Zufällige Abweichung (±%)",
+                            name: "jitterPercent",
+                            type: "number",
+                            default: 25,
+                            description: "Streut die Wartezeit um ±N%, um Thundering-Herd-Effekte bei parallelen Executions zu vermeiden",
+                        },
+                        {
+                            displayName: "Max. Throttle-Versuche",
+                            name: "maxThrottleTries",
+                            type: "number",
+                            default: 10,
+                            description: "Maximale Anzahl Throttling-Retries bevor ein Fehler geworfen wird",
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+            const throttlingEnabled = this.getNodeParameter("throttlingEnabled", itemIndex, true);
+            const throttlingParams = throttlingEnabled
+                ? this.getNodeParameter("throttling", itemIndex, {})
+                : {};
+            const throttleCodes = new Set((throttlingParams.throttleCodes ?? ["429"]).map(String));
+            const defaultWaitMs = throttlingParams.defaultWaitMs ?? 10000;
+            const jitterPercent = throttlingParams.jitterPercent ?? 25;
+            const maxThrottleTries = Math.max(1, throttlingParams.maxThrottleTries ?? 10);
+            // ── Request-Optionen zusammenbauen ──────────────────────────────────────
+            const method = this.getNodeParameter("method", itemIndex, "GET");
+            const url = this.getNodeParameter("url", itemIndex);
+            const sendHeaders = this.getNodeParameter("sendHeaders", itemIndex, false);
+            const sendBody = this.getNodeParameter("sendBody", itemIndex, false);
+            // v2: IHttpRequestOptions – kein freies Objekt mehr
+            const requestOptions = {
+                method: method,
+                url,
+                returnFullResponse: true, // v2: Gibt { statusCode, headers, body } zurück
+                ignoreHttpStatusErrors: true, // verhindert automatisches Throw bei 4xx/5xx
+                headers: {},
+            };
+            if (sendHeaders) {
+                const headerParams = this.getNodeParameter("headerParameters.parameters", itemIndex, []);
+                for (const h of headerParams) {
+                    requestOptions.headers[h.name] = h.value;
+                }
+            }
+            if (sendBody) {
+                const contentType = this.getNodeParameter("contentType", itemIndex, "json");
+                const bodyRaw = this.getNodeParameter("body", itemIndex, "");
+                if (contentType === "json") {
+                    try {
+                        requestOptions.body = JSON.parse(bodyRaw);
+                    }
+                    catch {
+                        requestOptions.body = bodyRaw;
+                    }
+                    requestOptions.headers["content-type"] =
+                        "application/json";
+                }
+                else {
+                    requestOptions.body = bodyRaw;
+                }
+            }
+            // ── Throttling-Loop ─────────────────────────────────────────────────────
+            let throttleAttempt = 0;
+            while (true) {
+                // v2: this.helpers.httpRequest statt this.helpers.request
+                // Authentifizierung über httpRequestWithAuthentication wenn nötig
+                const authentication = this.getNodeParameter("authentication", itemIndex, "none");
+                let response;
+                try {
+                    if (authentication !== "none") {
+                        // Credential-Name aus authentication-Option ableiten
+                        const credMap = {
+                            basicAuth: "httpBasicAuth",
+                            headerAuth: "httpHeaderAuth",
+                            oAuth1: "oAuth1Api",
+                            oAuth2: "oAuth2Api",
+                        };
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        response = await this.helpers.httpRequestWithAuthentication(credMap[authentication] ?? authentication, requestOptions);
+                    }
+                    else {
+                        // v2: this.helpers.httpRequest
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        response = await this.helpers.httpRequest(requestOptions);
+                    }
+                }
+                catch (err) {
+                    // Netzwerkfehler → direkt werfen, nicht throtteln
+                    if (err instanceof n8n_workflow_1.NodeApiError)
+                        throw err;
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Netzwerkfehler: ${err.message}`, { itemIndex });
+                }
+                const statusStr = String(response.statusCode);
+                // ── Throttling-Branch ───────────────────────────────────────────────
+                // KRITISCH: Dieser Branch darf Retry-on-Fail NICHT auslösen.
+                // Deshalb kein throw, sondern manueller Sleep + continue.
+                if (throttlingEnabled && throttleCodes.has(statusStr)) {
+                    throttleAttempt++;
+                    if (throttleAttempt >= maxThrottleTries) {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Throttling: Maximale Anzahl Versuche (${maxThrottleTries}) erreicht. Letzter Status: ${response.statusCode}`, { itemIndex });
+                    }
+                    const baseWait = (0, throttling_1.computeWaitMs)(response.headers, defaultWaitMs);
+                    const wait = (0, throttling_1.applyJitter)(baseWait, jitterPercent);
+                    this.logger.info(`[Throttling] Status ${response.statusCode} – Item ${itemIndex}, Versuch ${throttleAttempt}/${maxThrottleTries}, warte ${Math.round(wait)}ms`);
+                    await sleep(wait);
+                    continue; // Retry – KEIN Retry-on-Fail
+                }
+                // ── Normaler Fehler (nicht Throttle-Code) ───────────────────────────
+                if (response.statusCode >= 400) {
+                    const continueOnFail = this.continueOnFail();
+                    if (continueOnFail) {
+                        returnData.push({
+                            json: {
+                                error: `HTTP ${response.statusCode}`,
+                                body: response.body,
+                            },
+                            pairedItem: { item: itemIndex },
+                        });
+                        break;
+                    }
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `HTTP ${response.statusCode}: ${JSON.stringify(response.body)}`, { itemIndex });
+                }
+                // ── Erfolg ──────────────────────────────────────────────────────────
+                const body = response.body;
+                const json = typeof body === "object" && body !== null
+                    ? body
+                    : { data: body };
+                returnData.push({
+                    json,
+                    pairedItem: { item: itemIndex },
+                });
+                break; // Erfolg → Loop verlassen
+            }
+        }
+        return [returnData];
+    }
+}
+exports.HttpRequestThrottled = HttpRequestThrottled;
+//# sourceMappingURL=HttpRequestThrottled.node.js.map

package/dist/nodes/HttpRequest/HttpRequestThrottled.node.js.map

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

package/dist/nodes/HttpRequest/throttling.d.ts

@@ -0,0 +1,55 @@
+/** Sicherheits-Cap: Server-Angaben über 5 Minuten werden auf diesen Wert begrenzt */
+export declare const MAX_THROTTLE_WAIT_MS = 300000;
+/**
+ * Vereinheitlicht alle Header-Keys auf Lowercase und wandelt
+ * Array-Werte (mehrfache Header) in Strings um.
+ */
+export declare function normalizeHeaders(raw: Record<string, unknown>): Record<string, string>;
+/**
+ * Gibt den ersten gültigen Integer aus den angegebenen Header-Keys zurück.
+ * Die Reihenfolge der Keys definiert die Priorität.
+ */
+export declare function firstPresentInt(h: Record<string, string>, keys: string[]): number | null;
+/**
+ * Parst den Retry-After-Header.
+ *
+ * Unterstützte Formate:
+ *   - Sekunden als Integer:  "30"
+ *   - HTTP-Date (RFC 7231):  "Wed, 19 Feb 2025 12:00:00 GMT"
+ *
+ * Gibt null zurück wenn das Format nicht erkannt wird.
+ */
+export declare function parseRetryAfterToMs(v: string): number | null;
+/**
+ * Berechnet die Wartezeit aus einem Rate-Limit-Reset-Header.
+ *
+ * Heuristik für den Timestamp-Typ:
+ *   > 10^12  → Milliseconds (moderner POSIX-ms)
+ *   > 10^9   → Seconds (klassischer Unix-Timestamp)
+ *   sonst    → Seconds (Fallback)
+ */
+export declare function parseResetToWaitMs(h: Record<string, string>): number | null;
+/**
+ * Berechnet die Wartezeit in Millisekunden aus den Response-Headern.
+ *
+ * Prioritätsreihenfolge:
+ *   1. Retry-After Header (expliziteste Server-Aussage)
+ *   2. Remaining = 0 → Reset-Timestamp oder Default
+ *   3. Reset-Timestamp allein
+ *   4. Konfigurierbarer Default-Wert
+ *
+ * Das Ergebnis wird auf MAX_THROTTLE_WAIT_MS gecappt.
+ */
+export declare function computeWaitMs(rawHeaders: Record<string, unknown>, defaultWaitMs: number): number;
+/**
+ * Wendet einen gleichverteilten Jitter auf die Wartezeit an.
+ *
+ * Zweck: Thundering-Herd verhindern, wenn viele parallele Executions
+ *        gleichzeitig nach einem 429 wiederanlaufen.
+ *
+ * @param baseMs    Basiswert in Millisekunden
+ * @param jitterPct Maximale Abweichung in Prozent (0–100)
+ * @returns Jitter-behafteter Wert, niemals negativ
+ */
+export declare function applyJitter(baseMs: number, jitterPct: number): number;
+//# sourceMappingURL=throttling.d.ts.map

package/dist/nodes/HttpRequest/throttling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttling.d.ts","sourceRoot":"","sources":["../../../src/nodes/HttpRequest/throttling.ts"],"names":[],"mappings":"AAIA,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAI5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzB,IAAI,EAAE,MAAM,EAAE,GACb,MAAM,GAAG,IAAI,CAQf;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe5D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB,MAAM,GAAG,IAAI,CAWf;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,aAAa,EAAE,MAAM,GACpB,MAAM,CA4BR;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKrE"}

package/dist/nodes/HttpRequest/throttling.js

@@ -0,0 +1,141 @@
+"use strict";
+// nodes/HttpRequest/throttling.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_THROTTLE_WAIT_MS = void 0;
+exports.normalizeHeaders = normalizeHeaders;
+exports.firstPresentInt = firstPresentInt;
+exports.parseRetryAfterToMs = parseRetryAfterToMs;
+exports.parseResetToWaitMs = parseResetToWaitMs;
+exports.computeWaitMs = computeWaitMs;
+exports.applyJitter = applyJitter;
+// ── Konstanten ────────────────────────────────────────────────────────────────
+/** Sicherheits-Cap: Server-Angaben über 5 Minuten werden auf diesen Wert begrenzt */
+exports.MAX_THROTTLE_WAIT_MS = 300000;
+// ── Header-Normalisierung ─────────────────────────────────────────────────────
+/**
+ * Vereinheitlicht alle Header-Keys auf Lowercase und wandelt
+ * Array-Werte (mehrfache Header) in Strings um.
+ */
+function normalizeHeaders(raw) {
+    const out = {};
+    for (const [k, v] of Object.entries(raw ?? {})) {
+        if (v == null)
+            continue;
+        out[k.toLowerCase()] = Array.isArray(v) ? String(v[0]) : String(v);
+    }
+    return out;
+}
+// ── Hilfsfunktionen ───────────────────────────────────────────────────────────
+/**
+ * Gibt den ersten gültigen Integer aus den angegebenen Header-Keys zurück.
+ * Die Reihenfolge der Keys definiert die Priorität.
+ */
+function firstPresentInt(h, keys) {
+    for (const k of keys) {
+        const v = h[k];
+        if (!v)
+            continue;
+        const n = parseInt(v, 10);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return null;
+}
+/**
+ * Parst den Retry-After-Header.
+ *
+ * Unterstützte Formate:
+ *   - Sekunden als Integer:  "30"
+ *   - HTTP-Date (RFC 7231):  "Wed, 19 Feb 2025 12:00:00 GMT"
+ *
+ * Gibt null zurück wenn das Format nicht erkannt wird.
+ */
+function parseRetryAfterToMs(v) {
+    const trimmed = v.trim();
+    if (/^\d+$/.test(trimmed)) {
+        const sec = parseInt(trimmed, 10);
+        return Number.isFinite(sec) && sec >= 0 ? sec * 1000 : null;
+    }
+    const dt = Date.parse(trimmed); // JS Date.parse verarbeitet RFC-1123 nativ
+    if (!Number.isNaN(dt)) {
+        const delta = dt - Date.now();
+        return delta > 0 ? delta : 0;
+    }
+    return null;
+}
+/**
+ * Berechnet die Wartezeit aus einem Rate-Limit-Reset-Header.
+ *
+ * Heuristik für den Timestamp-Typ:
+ *   > 10^12  → Milliseconds (moderner POSIX-ms)
+ *   > 10^9   → Seconds (klassischer Unix-Timestamp)
+ *   sonst    → Seconds (Fallback)
+ */
+function parseResetToWaitMs(h) {
+    const reset = firstPresentInt(h, [
+        "x-ratelimit-reset",
+        "x-hubspot-ratelimit-reset",
+        "ratelimit-reset",
+    ]);
+    if (reset === null)
+        return null;
+    const tsMs = reset > 1000000000000 ? reset : reset * 1000;
+    const delta = tsMs - Date.now();
+    return delta > 0 ? delta : 0;
+}
+// ── Kernfunktionen ────────────────────────────────────────────────────────────
+/**
+ * Berechnet die Wartezeit in Millisekunden aus den Response-Headern.
+ *
+ * Prioritätsreihenfolge:
+ *   1. Retry-After Header (expliziteste Server-Aussage)
+ *   2. Remaining = 0 → Reset-Timestamp oder Default
+ *   3. Reset-Timestamp allein
+ *   4. Konfigurierbarer Default-Wert
+ *
+ * Das Ergebnis wird auf MAX_THROTTLE_WAIT_MS gecappt.
+ */
+function computeWaitMs(rawHeaders, defaultWaitMs) {
+    const h = normalizeHeaders(rawHeaders);
+    const cap = (ms) => Math.min(ms, exports.MAX_THROTTLE_WAIT_MS);
+    // 1) Retry-After
+    const ra = h["retry-after"];
+    if (ra) {
+        const ms = parseRetryAfterToMs(ra);
+        if (ms !== null && ms > 0)
+            return cap(ms);
+    }
+    // 2) Remaining = 0
+    const remaining = firstPresentInt(h, [
+        "x-ratelimit-remaining",
+        "x-hubspot-ratelimit-remaining",
+        "ratelimit-remaining",
+    ]);
+    if (remaining !== null && remaining <= 0) {
+        const resetMs = parseResetToWaitMs(h);
+        return cap(resetMs !== null && resetMs > 0 ? resetMs : defaultWaitMs);
+    }
+    // 3) Reset-Timestamp
+    const resetMs = parseResetToWaitMs(h);
+    if (resetMs !== null && resetMs > 0)
+        return cap(resetMs);
+    // 4) Fallback
+    return cap(defaultWaitMs);
+}
+/**
+ * Wendet einen gleichverteilten Jitter auf die Wartezeit an.
+ *
+ * Zweck: Thundering-Herd verhindern, wenn viele parallele Executions
+ *        gleichzeitig nach einem 429 wiederanlaufen.
+ *
+ * @param baseMs    Basiswert in Millisekunden
+ * @param jitterPct Maximale Abweichung in Prozent (0–100)
+ * @returns Jitter-behafteter Wert, niemals negativ
+ */
+function applyJitter(baseMs, jitterPct) {
+    const pct = Math.max(0, Math.min(100, jitterPct));
+    const variance = baseMs * (pct / 100);
+    const jitter = (Math.random() * 2 - 1) * variance;
+    return Math.max(0, baseMs + jitter);
+}
+//# sourceMappingURL=throttling.js.map

package/dist/nodes/HttpRequest/throttling.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@bauer-group/n8n-nodes-http-throttled-request",
+  "version": "0.1.1",
+  "description": "n8n community node with built-in HTTP request throttling (rate limiting)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bauer-group/EXT-n8n-httpThrottled.git"
+  },
+  "main": "dist/nodes/HttpRequest/HttpRequestThrottled.node.js",
+  "n8n": {
+    "nodes": [
+      {
+        "file": "dist/nodes/HttpRequest/HttpRequestThrottled.node.js"
+      }
+    ]
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsc -p tsconfig.json",
+    "rebuild": "npm run clean && npm run build",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "n8n-workflow": ">=2.9.0 <3",
+    "n8n-core": ">=2.9.0 <3"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "@types/node": "^25.3.0",
+    "jest": "^30.2.0",
+    "@types/jest": "^30.0.0",
+    "ts-jest": "^29.4.6",
+    "n8n-workflow": "^2.9.0",
+    "n8n-core": "^2.9.0",
+    "rimraf": "^6.1.3"
+  },
+  "jest": {
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/test/**/*.test.ts"
+    ],
+    "transform": {
+      "^.+\\.ts$": [
+        "ts-jest",
+        {
+          "tsconfig": "tsconfig.test.json"
+        }
+      ]
+    }
+  }
+}