n8n-nodes-message-debounce 0.1.2

package/dist/nodes/MessageDebounce/MessageDebounce.node.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * MessageDebounce n8n community node — entry point.
+ *
+ * Intentionally thin: this file wires together the separated modules.
+ *
+ * Module map:
+ *   description.ts        → INodeTypeDescription (UI definition)
+ *   execute.ts            → runDebounce() (core debounce business logic)
+ *   types.ts              → shared interfaces and types
+ *   constants.ts          → Lua script, TTL multipliers
+ *   helpers.ts            → pure utility functions
+ *   utils/RedisClient.ts  → native RESP2 Redis client (zero external deps)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageDebounce = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const MessageDebounce_description_1 = require("./MessageDebounce.description");
+const execute_1 = require("./execute");
+const RedisClient_1 = require("./utils/RedisClient");
+// eslint-disable-next-line @n8n/community-nodes/icon-validation -- icon is defined in MessageDebounce.description.ts
+class MessageDebounce {
+    constructor() {
+        this.description = MessageDebounce_description_1.description;
+    }
+    async execute() {
+        const itemIndex = 0;
+        // ------------------------------------------------------------------
+        // 1. Validate required parameters
+        // ------------------------------------------------------------------
+        const sessionId = this.getNodeParameter('sessionId', itemIndex, '').trim();
+        const message = this.getNodeParameter('message', itemIndex, '');
+        const debounceWindowRaw = this.getNodeParameter('debounceWindow', itemIndex, null);
+        if (!sessionId) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Session ID is required', {
+                itemIndex,
+                description: 'Set the Session ID field to a unique identifier for this conversation.',
+            });
+        }
+        if (!message && message !== '0') {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Message is required', {
+                itemIndex,
+                description: 'Set the Message field to the content you want to buffer.',
+            });
+        }
+        if (debounceWindowRaw === null || debounceWindowRaw === '' || debounceWindowRaw === undefined) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Debounce Window is required', {
+                itemIndex,
+                description: 'Enter the number of seconds to wait for silence before flushing messages.',
+            });
+        }
+        const debounceWindowSec = Number(debounceWindowRaw);
+        if (isNaN(debounceWindowSec) || debounceWindowSec < 1) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Debounce Window must be a positive number (minimum 1 second)', { itemIndex });
+        }
+        // ------------------------------------------------------------------
+        // 2. Resolve options
+        // ------------------------------------------------------------------
+        const raw = this.getNodeParameter('options', itemIndex, {});
+        const opts = {
+            maxMessages: Number(raw.maxMessages ?? 0),
+            maxWaitTimeSec: Number(raw.maxWaitTime ?? 0),
+            separator: raw.separator !== undefined ? raw.separator : '\n',
+            onDuplicate: raw.onDuplicateMessage ?? 'include',
+            firstMsgBehavior: raw.firstMessageBehavior ?? 'none',
+            firstMsgCustomWindow: Number(raw.firstMessageCustomWindow ?? 3),
+            sessionTtlUnit: raw.sessionTtlUnit ?? 'never',
+            sessionTtlValue: Number(raw.sessionTtlValue ?? 30),
+            flushKeywords: (raw.flushKeywords?.keywords ?? [])
+                .map((k) => k.keyword?.trim().toLowerCase())
+                .filter(Boolean),
+        };
+        // ------------------------------------------------------------------
+        // 3. Connect to Redis
+        // ------------------------------------------------------------------
+        let credentials;
+        try {
+            credentials = (await this.getCredentials('redisApi'));
+        }
+        catch (err) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Redis credentials error: ${err instanceof Error ? err.message : String(err)}`, { itemIndex });
+        }
+        const redis = new RedisClient_1.RedisClient(credentials);
+        try {
+            await redis.connect();
+        }
+        catch (err) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Redis connection failed: ${err instanceof Error ? err.message : String(err)}`, { itemIndex });
+        }
+        // ------------------------------------------------------------------
+        // 4. Run debounce logic (see execute.ts)
+        // ------------------------------------------------------------------
+        try {
+            return await (0, execute_1.runDebounce)(redis, sessionId, message, debounceWindowSec, opts, itemIndex);
+        }
+        finally {
+            redis.disconnect();
+        }
+    }
+}
+exports.MessageDebounce = MessageDebounce;
+//# sourceMappingURL=MessageDebounce.node.js.map

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

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

package/dist/nodes/MessageDebounce/constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Lua script for atomic compare-and-flush in Redis.
+ *
+ * KEYS[1] = messages list key  (debounce:{sessionId}:msgs)
+ * KEYS[2] = startTime key      (debounce:{sessionId}:startTime)
+ * ARGV[1] = beforeId           (UUID of the message pushed by this execution)
+ *
+ * Returns: array of raw JSON message entries if this execution wins the race,
+ *          or nil if another message arrived after this one (we are not the last).
+ *
+ * The script is atomic — executed by a single Redis server command, so no
+ * race conditions can occur between the LINDEX check and the LRANGE+DEL.
+ */
+export declare const FLUSH_SCRIPT = "\nlocal key  = KEYS[1]\nlocal tkey = KEYS[2]\nlocal bid  = ARGV[1]\n\nlocal last = redis.call('LINDEX', key, -1)\nif not last then return nil end\n\nlocal ok, entry = pcall(cjson.decode, last)\nif not ok then return nil end\nif entry.id ~= bid then return nil end\n\nlocal all = redis.call('LRANGE', key, 0, -1)\nredis.call('DEL', key)\nredis.call('DEL', tkey)\nreturn all\n";
+/** Session TTL multipliers: converts a user-facing unit to seconds. */
+export declare const TTL_MULTIPLIERS: Record<string, number>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/nodes/MessageDebounce/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../nodes/MessageDebounce/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,2XAgBxB,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMlD,CAAC"}

package/dist/nodes/MessageDebounce/constants.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TTL_MULTIPLIERS = exports.FLUSH_SCRIPT = void 0;
+/**
+ * Lua script for atomic compare-and-flush in Redis.
+ *
+ * KEYS[1] = messages list key  (debounce:{sessionId}:msgs)
+ * KEYS[2] = startTime key      (debounce:{sessionId}:startTime)
+ * ARGV[1] = beforeId           (UUID of the message pushed by this execution)
+ *
+ * Returns: array of raw JSON message entries if this execution wins the race,
+ *          or nil if another message arrived after this one (we are not the last).
+ *
+ * The script is atomic — executed by a single Redis server command, so no
+ * race conditions can occur between the LINDEX check and the LRANGE+DEL.
+ */
+exports.FLUSH_SCRIPT = `
+local key  = KEYS[1]
+local tkey = KEYS[2]
+local bid  = ARGV[1]
+
+local last = redis.call('LINDEX', key, -1)
+if not last then return nil end
+
+local ok, entry = pcall(cjson.decode, last)
+if not ok then return nil end
+if entry.id ~= bid then return nil end
+
+local all = redis.call('LRANGE', key, 0, -1)
+redis.call('DEL', key)
+redis.call('DEL', tkey)
+return all
+`;
+/** Session TTL multipliers: converts a user-facing unit to seconds. */
+exports.TTL_MULTIPLIERS = {
+    minutes: 60,
+    hours: 3600,
+    days: 86400,
+    months: 30 * 86400, // approximate (30 days)
+    years: 365 * 86400, // approximate (365 days)
+};
+//# sourceMappingURL=constants.js.map

package/dist/nodes/MessageDebounce/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../nodes/MessageDebounce/constants.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACU,QAAA,YAAY,GAAG;;;;;;;;;;;;;;;;CAgB3B,CAAC;AAEF,uEAAuE;AAC1D,QAAA,eAAe,GAA2B;IACnD,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,IAAK;IACZ,IAAI,EAAE,KAAM;IACZ,MAAM,EAAE,EAAE,GAAG,KAAM,EAAI,wBAAwB;IAC/C,KAAK,EAAE,GAAG,GAAG,KAAM,EAAI,yBAAyB;CACnD,CAAC"}

package/dist/nodes/MessageDebounce/execute.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Core debounce execution flow for the MessageDebounce node.
+ *
+ * Extracted from MessageDebounce.node.ts so that execute() (which TypeScript
+ * types as `this: IExecuteFunctions`) can call it cleanly as a standalone function.
+ *
+ * All business logic for buffering, flushing, and race-condition handling lives here.
+ */
+import type { INodeExecutionData } from 'n8n-workflow';
+import type { ResolvedOptions } from './types';
+import type { RedisClient } from './utils/RedisClient';
+export declare function runDebounce(redis: RedisClient, sessionId: string, message: string, debounceWindowSec: number, opts: ResolvedOptions, itemIndex: number): Promise<INodeExecutionData[][]>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/nodes/MessageDebounce/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../nodes/MessageDebounce/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIpE,OAAO,KAAK,EAA6C,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,wBAAsB,WAAW,CAC7B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CA4MjC"}

package/dist/nodes/MessageDebounce/execute.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Core debounce execution flow for the MessageDebounce node.
+ *
+ * Extracted from MessageDebounce.node.ts so that execute() (which TypeScript
+ * types as `this: IExecuteFunctions`) can call it cleanly as a standalone function.
+ *
+ * All business logic for buffering, flushing, and race-condition handling lives here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDebounce = runDebounce;
+const crypto_1 = require("crypto");
+const constants_1 = require("./constants");
+const helpers_1 = require("./helpers");
+async function runDebounce(redis, sessionId, message, debounceWindowSec, opts, itemIndex) {
+    const { msgKey, tsKey } = (0, helpers_1.makeKeys)(sessionId);
+    /** Reads all buffered messages, deletes Redis keys, returns n8n output. */
+    const flush = async (reason) => {
+        let entries;
+        try {
+            entries = await redis.lrange(msgKey, 0, -1);
+            await redis.del(msgKey, tsKey);
+        }
+        catch (err) {
+            throw (0, helpers_1.wrapRedisError)(err);
+        }
+        const messages = entries.map((raw) => {
+            try {
+                return JSON.parse(raw).content;
+            }
+            catch {
+                return raw;
+            }
+        });
+        const output = {
+            fullMessage: messages.join(opts.separator),
+            messageCount: messages.length,
+            flushReason: reason,
+        };
+        return [[{ json: output, pairedItem: { item: itemIndex } }]];
+    };
+    // -------------------------------------------------------------------------
+    // Step 1 — Is this the first message in the session?
+    // -------------------------------------------------------------------------
+    let currentLen;
+    try {
+        currentLen = await redis.llen(msgKey);
+    }
+    catch (err) {
+        throw (0, helpers_1.wrapRedisError)(err);
+    }
+    const isFirstMessage = currentLen === 0;
+    // -------------------------------------------------------------------------
+    // Step 2 — First-message special behaviors
+    // -------------------------------------------------------------------------
+    if (isFirstMessage && opts.firstMsgBehavior === 'immediate') {
+        const entry = { id: (0, crypto_1.randomUUID)(), content: message };
+        try {
+            await redis.rpush(msgKey, JSON.stringify(entry));
+        }
+        catch (err) {
+            throw (0, helpers_1.wrapRedisError)(err);
+        }
+        return flush('firstMessage');
+    }
+    // -------------------------------------------------------------------------
+    // Step 3 — Duplicate message handling
+    // -------------------------------------------------------------------------
+    if (opts.onDuplicate !== 'include') {
+        let lastRaw = null;
+        try {
+            lastRaw = await redis.lindex(msgKey, -1);
+        }
+        catch (err) {
+            throw (0, helpers_1.wrapRedisError)(err);
+        }
+        if (lastRaw !== null) {
+            let lastEntry = null;
+            try {
+                lastEntry = JSON.parse(lastRaw);
+            }
+            catch {
+                // malformed entry — treat as not duplicate
+            }
+            if (lastEntry?.content === message) {
+                if (opts.onDuplicate === 'ignore')
+                    return [[]];
+                if (opts.onDuplicate === 'flush') {
+                    const entry = { id: (0, crypto_1.randomUUID)(), content: message };
+                    try {
+                        await redis.rpush(msgKey, JSON.stringify(entry));
+                    }
+                    catch (err) {
+                        throw (0, helpers_1.wrapRedisError)(err);
+                    }
+                    return flush('duplicate');
+                }
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Step 4 — Flush keywords
+    // -------------------------------------------------------------------------
+    if (opts.flushKeywords.length > 0) {
+        const lower = message.toLowerCase();
+        if (opts.flushKeywords.some((kw) => lower.includes(kw))) {
+            const entry = { id: (0, crypto_1.randomUUID)(), content: message };
+            try {
+                await redis.rpush(msgKey, JSON.stringify(entry));
+            }
+            catch (err) {
+                throw (0, helpers_1.wrapRedisError)(err);
+            }
+            return flush('keyword');
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Step 5 — Push message + record session metadata
+    // -------------------------------------------------------------------------
+    const entry = { id: (0, crypto_1.randomUUID)(), content: message };
+    let newLen;
+    try {
+        newLen = await redis.rpush(msgKey, JSON.stringify(entry));
+    }
+    catch (err) {
+        throw (0, helpers_1.wrapRedisError)(err);
+    }
+    // Record start time only once per session (NX flag).
+    try {
+        await redis.set(tsKey, String(Date.now()), { nx: true });
+    }
+    catch (err) {
+        throw (0, helpers_1.wrapRedisError)(err);
+    }
+    // Apply Session TTL (0 = never expire).
+    const ttlSec = (0, helpers_1.toTtlSeconds)(opts.sessionTtlValue, opts.sessionTtlUnit);
+    if (ttlSec > 0) {
+        try {
+            await redis.expire(msgKey, ttlSec);
+            await redis.expire(tsKey, ttlSec);
+        }
+        catch (err) {
+            throw (0, helpers_1.wrapRedisError)(err);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Step 6 — Max messages threshold (flush before sleeping)
+    // -------------------------------------------------------------------------
+    if (opts.maxMessages > 0 && newLen >= opts.maxMessages) {
+        return flush('maxMessages');
+    }
+    // -------------------------------------------------------------------------
+    // Step 7 — Sleep (debounce window, racing against maxWait if configured)
+    // -------------------------------------------------------------------------
+    const windowMs = isFirstMessage && opts.firstMsgBehavior === 'customWindow'
+        ? opts.firstMsgCustomWindow * 1000
+        : debounceWindowSec * 1000;
+    let maxWaitMs = 0;
+    if (opts.maxWaitTimeSec > 0) {
+        let startTimeRaw = null;
+        try {
+            startTimeRaw = await redis.get(tsKey);
+        }
+        catch (err) {
+            throw (0, helpers_1.wrapRedisError)(err);
+        }
+        if (startTimeRaw !== null) {
+            const elapsed = Date.now() - parseInt(startTimeRaw, 10);
+            maxWaitMs = Math.max(0, opts.maxWaitTimeSec * 1000 - elapsed);
+        }
+    }
+    let timedOutByMaxWait = false;
+    if (opts.maxWaitTimeSec > 0 && maxWaitMs <= windowMs) {
+        await Promise.race([
+            (0, helpers_1.sleep)(windowMs),
+            (0, helpers_1.sleep)(maxWaitMs).then(() => {
+                timedOutByMaxWait = true;
+            }),
+        ]);
+    }
+    else {
+        await (0, helpers_1.sleep)(windowMs);
+    }
+    if (timedOutByMaxWait) {
+        return flush('maxWaitTime');
+    }
+    // -------------------------------------------------------------------------
+    // Step 8 — Atomic Lua compare-and-flush
+    // -------------------------------------------------------------------------
+    let luaResult;
+    try {
+        luaResult = await redis.eval(constants_1.FLUSH_SCRIPT, [msgKey, tsKey], [entry.id]);
+    }
+    catch (err) {
+        throw (0, helpers_1.wrapRedisError)(err);
+    }
+    if (luaResult === null || !Array.isArray(luaResult)) {
+        // A newer message arrived after ours — stop the flow silently, no output.
+        return [[]];
+    }
+    // We won the race — emit the full consolidated message.
+    const messages = luaResult.map((raw) => {
+        try {
+            return JSON.parse(raw).content;
+        }
+        catch {
+            return raw;
+        }
+    });
+    const output = {
+        fullMessage: messages.join(opts.separator),
+        messageCount: messages.length,
+        flushReason: 'debounceWindow',
+    };
+    return [[{ json: output, pairedItem: { item: itemIndex } }]];
+}
+//# sourceMappingURL=execute.js.map

package/dist/nodes/MessageDebounce/execute.js.map

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

package/dist/nodes/MessageDebounce/helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure helper functions for the MessageDebounce node.
+ * No n8n or Redis imports here — just plain TypeScript utilities.
+ */
+/** Promise-based sleep using setInterval (avoids the restricted `setTimeout` global). */
+export declare function sleep(ms: number): Promise<void>;
+/** Returns the Redis key names for a given session ID. */
+export declare function makeKeys(sessionId: string): {
+    msgKey: string;
+    tsKey: string;
+};
+/** Wraps a Redis error with a user-friendly prefix. */
+export declare function wrapRedisError(err: unknown): Error;
+/**
+ * Converts a user-facing TTL (value + unit) to seconds.
+ * Returns 0 when unit is 'never' (no expiry).
+ */
+export declare function toTtlSeconds(value: number, unit: string): number;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/nodes/MessageDebounce/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../nodes/MessageDebounce/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,yFAAyF;AACzF,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/C;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAK7E;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAGlD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhE"}

package/dist/nodes/MessageDebounce/helpers.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Pure helper functions for the MessageDebounce node.
+ * No n8n or Redis imports here — just plain TypeScript utilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+exports.makeKeys = makeKeys;
+exports.wrapRedisError = wrapRedisError;
+exports.toTtlSeconds = toTtlSeconds;
+const constants_1 = require("./constants");
+/** Promise-based sleep using setInterval (avoids the restricted `setTimeout` global). */
+function sleep(ms) {
+    return new Promise((resolve) => {
+        const handle = setInterval(() => {
+            clearInterval(handle);
+            resolve();
+        }, ms);
+    });
+}
+/** Returns the Redis key names for a given session ID. */
+function makeKeys(sessionId) {
+    return {
+        msgKey: `debounce:${sessionId}:msgs`,
+        tsKey: `debounce:${sessionId}:startTime`,
+    };
+}
+/** Wraps a Redis error with a user-friendly prefix. */
+function wrapRedisError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return new Error(`Redis operation failed: ${msg}`);
+}
+/**
+ * Converts a user-facing TTL (value + unit) to seconds.
+ * Returns 0 when unit is 'never' (no expiry).
+ */
+function toTtlSeconds(value, unit) {
+    if (unit === 'never')
+        return 0;
+    const multiplier = constants_1.TTL_MULTIPLIERS[unit] ?? 60;
+    return Math.round(value * multiplier);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/nodes/MessageDebounce/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../nodes/MessageDebounce/helpers.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAKH,sBAOC;AAGD,4BAKC;AAGD,wCAGC;AAMD,oCAIC;AAlCD,2CAA8C;AAE9C,yFAAyF;AACzF,SAAgB,KAAK,CAAC,EAAU;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,aAAa,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO,EAAE,CAAC;QACd,CAAC,EAAE,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACP,CAAC;AAED,0DAA0D;AAC1D,SAAgB,QAAQ,CAAC,SAAiB;IACtC,OAAO;QACH,MAAM,EAAE,YAAY,SAAS,OAAO;QACpC,KAAK,EAAE,YAAY,SAAS,YAAY;KAC3C,CAAC;AACN,CAAC;AAED,uDAAuD;AACvD,SAAgB,cAAc,CAAC,GAAY;IACvC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,KAAa,EAAE,IAAY;IACpD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,2BAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC;AAC1C,CAAC"}

package/dist/nodes/MessageDebounce/messageDebounce.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" fill="none">
+  <!-- Background circle -->
+  <circle cx="30" cy="30" r="28" fill="#FF6B35" opacity="0.12"/>
+  <!-- Clock face -->
+  <circle cx="30" cy="30" r="20" stroke="#FF6B35" stroke-width="2.5" fill="none"/>
+  <!-- Clock hands -->
+  <line x1="30" y1="30" x2="30" y2="16" stroke="#FF6B35" stroke-width="2.5" stroke-linecap="round"/>
+  <line x1="30" y1="30" x2="40" y2="35" stroke="#FF6B35" stroke-width="2" stroke-linecap="round"/>
+  <!-- Center dot -->
+  <circle cx="30" cy="30" r="2" fill="#FF6B35"/>
+  <!-- Message dots (debounce indicator) -->
+  <circle cx="10" cy="48" r="3" fill="#FF6B35" opacity="0.4"/>
+  <circle cx="20" cy="52" r="3" fill="#FF6B35" opacity="0.65"/>
+  <circle cx="30" cy="54" r="3" fill="#FF6B35" opacity="0.9"/>
+  <!-- Arrow suggesting consolidation -->
+  <path d="M38 54 L50 54 L46 50 M50 54 L46 58" stroke="#FF6B35" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" opacity="0.8"/>
+</svg>

package/dist/nodes/MessageDebounce/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Type definitions for the MessageDebounce node.
+ * Single source of truth for shared interfaces and types.
+ */
+/** Reason that triggered a debounce flush. */
+export type FlushReason = 'debounceWindow' | 'maxMessages' | 'maxWaitTime' | 'keyword' | 'firstMessage' | 'duplicate';
+/** A single buffered message stored in Redis. */
+export interface MessageEntry {
+    id: string;
+    content: string;
+}
+/** The consolidated output emitted when a flush occurs. */
+export interface DebounceOutput {
+    fullMessage: string;
+    messageCount: number;
+    flushReason: FlushReason;
+}
+/** Resolved options from the node's Options collection. */
+export interface ResolvedOptions {
+    maxMessages: number;
+    maxWaitTimeSec: number;
+    separator: string;
+    onDuplicate: string;
+    firstMsgBehavior: string;
+    firstMsgCustomWindow: number;
+    sessionTtlUnit: string;
+    sessionTtlValue: number;
+    flushKeywords: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/nodes/MessageDebounce/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../nodes/MessageDebounce/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GACjB,gBAAgB,GAChB,aAAa,GACb,aAAa,GACb,SAAS,GACT,cAAc,GACd,WAAW,CAAC;AAElB,iDAAiD;AACjD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC5B;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CAC3B"}

package/dist/nodes/MessageDebounce/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Type definitions for the MessageDebounce node.
+ * Single source of truth for shared interfaces and types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/nodes/MessageDebounce/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../nodes/MessageDebounce/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/nodes/MessageDebounce/utils/RedisClient.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Minimal Redis client using the native Node.js `net` module.
+ * Implements the RESP2 (REdis Serialization Protocol) specification.
+ * Zero external dependencies — required for n8n verified community nodes.
+ *
+ * Supported commands: AUTH, SELECT, RPUSH, LLEN, LINDEX, LRANGE, DEL, EXPIRE, SET, GET, EVAL
+ */
+export interface RedisCredentials {
+    host: string;
+    port: number;
+    username?: string;
+    password?: string;
+    database?: number;
+    tls?: boolean;
+}
+type RespValue = string | number | null | RespValue[];
+export declare class RedisClient {
+    private socket;
+    private readonly host;
+    private readonly port;
+    private readonly username;
+    private readonly password;
+    private readonly database;
+    private readonly useTls;
+    private pendingCallbacks;
+    private parser;
+    constructor(credentials: RedisCredentials);
+    /** Establish connection and authenticate. */
+    connect(): Promise<void>;
+    /** Close the socket gracefully. */
+    disconnect(): void;
+    rpush(key: string, value: string): Promise<number>;
+    llen(key: string): Promise<number>;
+    lindex(key: string, index: number): Promise<string | null>;
+    lrange(key: string, start: number, stop: number): Promise<string[]>;
+    del(...keys: string[]): Promise<number>;
+    expire(key: string, seconds: number): Promise<number>;
+    /**
+     * SET with optional NX and EX flags.
+     * Returns 'OK' on success, null if NX condition was not met.
+     */
+    set(key: string, value: string, options?: {
+        nx?: boolean;
+        ex?: number;
+    }): Promise<string | null>;
+    get(key: string): Promise<string | null>;
+    /**
+     * Execute a Lua script atomically.
+     * @param script  Lua source code
+     * @param keys    KEYS array
+     * @param args    ARGV array
+     */
+    eval(script: string, keys: string[], args: string[]): Promise<RespValue>;
+    private openSocket;
+    private send;
+    private drainParser;
+}
+export {};
+//# sourceMappingURL=RedisClient.d.ts.map

package/dist/nodes/MessageDebounce/utils/RedisClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisClient.d.ts","sourceRoot":"","sources":["../../../../nodes/MessageDebounce/utils/RedisClient.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC;AA+EtD,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,gBAAgB,CACjB;IACP,OAAO,CAAC,MAAM,CAAoB;gBAEtB,WAAW,EAAE,gBAAgB;IASzC,6CAA6C;IACvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC9B,mCAAmC;IACnC,UAAU,IAAI,IAAI;IAWZ,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI1D,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKnE,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D;;;OAGG;IACG,GAAG,CACL,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWnB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9C;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAQ9E,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,WAAW;CAetB"}