@catalogicus-international/n8n-nodes-telegram-advance 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Catalogicus International
+
+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,100 @@
+# @catalogicus-international/n8n-nodes-telegram-advance
+
+An n8n community package for Telegram-native human-in-the-loop workflows.
+It sends a question and pauses the current execution until the user responds
+inside Telegram. No n8n approval page or external response form is opened.
+
+## Nodes
+
+### Telegram Advance
+
+Use this node in the workflow branch that needs a human response. It supports:
+
+- **Approval** — approve and decline inline buttons;
+- **Choice** — custom inline buttons, for example a product or delivery option;
+- **Free Text** — the user replies directly to the bot message.
+
+The node resumes with data shaped like:
+
+```json
+{
+  "response": {
+    "type": "choice",
+    "value": "sku-123",
+    "label": "Product A",
+    "user": {
+      "id": 123456789,
+      "username": "example"
+    },
+    "chat": {
+      "id": 123456789
+    },
+    "questionMessageId": 42,
+    "receivedAt": "2026-06-21T12:00:00.000Z"
+  }
+}
+```
+
+Approval responses also contain `approved: true` or `approved: false`.
+Free-text responses contain `text` and return the same value in `value`.
+
+### Telegram Advance Trigger
+
+Add exactly one trigger for the bot to the **same workflow** as the waiting
+Telegram Advance nodes, then activate the workflow. The trigger owns the
+Telegram webhook and routes button clicks or message replies to the correct
+waiting execution.
+
+The trigger emits a small internal event with `telegramAdvanceRouted: true`
+after a response is routed. Leaving the trigger disconnected is the simplest
+setup. If you connect it to other nodes, filter out routed events unless you
+intentionally want to process them.
+
+The trigger can also emit Telegram messages and callbacks that do not belong
+to a waiting question. Disable **Emit Unmatched Updates** if the workflow only
+uses the trigger as an internal response router.
+
+## Setup
+
+1. Create a bot with [BotFather](https://t.me/BotFather) and copy its token.
+2. Create `Telegram Advance API` credentials in n8n.
+3. Create an Upstash-compatible Redis REST database and add its HTTPS URL and
+   token as `Telegram Advance Store API` credentials.
+4. Add `Telegram Advance Trigger` to the workflow and select both credentials.
+5. Add `Telegram Advance` where the workflow must pause for a response, using
+   the same store credentials.
+6. Activate the workflow.
+
+Telegram permits only one webhook per bot. Do not use the same bot with another
+Telegram Trigger in a different active workflow.
+
+For free-text questions, the user must reply to the bot's question message.
+This lets the trigger distinguish several concurrent pending questions in the
+same chat.
+
+## Reliability notes
+
+Pending response routes are stored in Redis rather than workflow static data,
+so the trigger can route responses across n8n workers and after process
+restarts. Responses are claimed atomically before an execution is resumed,
+which makes duplicate Telegram webhook deliveries harmless.
+
+When a wait timeout is configured, Redis removes its route at the same time.
+Routes without a timeout remain until the user responds.
+
+## Development
+
+```bash
+pnpm install
+pnpm run lint
+pnpm test
+```
+
+## Resources
+
+- [Telegram Bot API](https://core.telegram.org/bots/api)
+- [n8n community node documentation](https://docs.n8n.io/integrations/creating-nodes/)
+
+## License
+
+[MIT](LICENSE.md)

package/dist/credentials/TelegramAdvanceApi.credentials.d.ts

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

package/dist/credentials/TelegramAdvanceApi.credentials.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramAdvanceApi = void 0;
+class TelegramAdvanceApi {
+    constructor() {
+        this.name = 'telegramAdvanceApi';
+        this.displayName = 'Telegram Advance API';
+        this.icon = 'file:../icons/telegram.svg';
+        this.documentationUrl = 'https://core.telegram.org/bots/features#creating-a-new-bot';
+        this.properties = [
+            {
+                displayName: 'Bot Access Token',
+                name: 'accessToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Token provided by BotFather',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.telegram.org',
+                required: true,
+                description: 'Telegram Bot API base URL, or the URL of a local Bot API server',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {},
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '={{"/bot" + $credentials.accessToken + "/getMe"}}',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.TelegramAdvanceApi = TelegramAdvanceApi;
+//# sourceMappingURL=TelegramAdvanceApi.credentials.js.map

package/dist/credentials/TelegramAdvanceApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramAdvanceApi.credentials.js","sourceRoot":"","sources":["../../credentials/TelegramAdvanceApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,kBAAkB;IAA/B;QACC,SAAI,GAAG,oBAAoB,CAAC;QAE5B,gBAAW,GAAG,sBAAsB,CAAC;QAErC,SAAI,GAAS,4BAA4B,CAAC;QAE1C,qBAAgB,GAAG,4DAA4D,CAAC;QAEhF,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,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,EAAE,6BAA6B;aAC1C;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,0BAA0B;gBACnC,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,iEAAiE;aAC9E;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE;SACd,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,mDAAmD;gBACxD,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAzCD,gDAyCC"}

package/dist/credentials/TelegramAdvanceStoreApi.credentials.d.ts

@@ -0,0 +1,8 @@
+import type { Icon, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class TelegramAdvanceStoreApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/TelegramAdvanceStoreApi.credentials.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramAdvanceStoreApi = void 0;
+class TelegramAdvanceStoreApi {
+    constructor() {
+        this.name = 'telegramAdvanceStoreApi';
+        this.displayName = 'Telegram Advance Store API';
+        this.icon = 'file:../icons/telegram.svg';
+        this.documentationUrl = 'https://redis.io/docs/latest/develop/clients/';
+        this.properties = [
+            {
+                displayName: 'Redis REST URL',
+                name: 'redisRestUrl',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'Upstash-compatible Redis REST URL. Use the same database for the waiting node and trigger.',
+            },
+            {
+                displayName: 'Redis REST Token',
+                name: 'redisRestToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Bearer token for the Redis REST API',
+            },
+            {
+                displayName: 'Key Prefix',
+                name: 'keyPrefix',
+                type: 'string',
+                default: 'telegram-advance',
+                required: true,
+                description: 'Prefix used to isolate Telegram Advance routes in Redis',
+            },
+        ];
+    }
+}
+exports.TelegramAdvanceStoreApi = TelegramAdvanceStoreApi;
+//# sourceMappingURL=TelegramAdvanceStoreApi.credentials.js.map

package/dist/credentials/TelegramAdvanceStoreApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramAdvanceStoreApi.credentials.js","sourceRoot":"","sources":["../../credentials/TelegramAdvanceStoreApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,uBAAuB;IAApC;QACC,SAAI,GAAG,yBAAyB,CAAC;QAEjC,gBAAW,GAAG,4BAA4B,CAAC;QAE3C,SAAI,GAAS,4BAA4B,CAAC;QAE1C,qBAAgB,GAAG,+CAA+C,CAAC;QAEnE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EACV,4FAA4F;aAC7F;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,qCAAqC;aAClD;YACD;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,kBAAkB;gBAC3B,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,yDAAyD;aACtE;SACD,CAAC;IACH,CAAC;CAAA;AArCD,0DAqCC"}

package/dist/icons/telegram.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="12" fill="#229ED9"/>
+  <path fill="#fff" d="M18.9 6.2 16.5 18c-.2.8-.7 1-1.4.6l-3.7-2.7-1.8 1.7c-.2.2-.4.4-.8.4l.3-3.8 6.9-6.3c.3-.3-.1-.4-.5-.2L7 13l-3.7-1.2c-.8-.3-.8-.8.2-1.2l14.4-5.5c.7-.2 1.3.2 1 .9Z"/>
+</svg>

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

@@ -0,0 +1,11 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription, IWebhookFunctions, IWebhookResponseData } from 'n8n-workflow';
+export declare class TelegramAdvance implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        credentialTest: {
+            telegramAdvanceStoreApiTest: import("n8n-workflow").ICredentialTestFunction;
+        };
+    };
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/TelegramAdvance/TelegramAdvance.node.js

@@ -0,0 +1,343 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramAdvance = void 0;
+const crypto_1 = require("crypto");
+const n8n_workflow_1 = require("n8n-workflow");
+const question_1 = require("../question");
+const redisPendingStore_1 = require("../redisPendingStore");
+const shared_1 = require("../shared");
+const wait_1 = require("../wait");
+class TelegramAdvance {
+    constructor() {
+        this.description = {
+            displayName: 'Telegram Advance',
+            name: 'telegramAdvance',
+            icon: 'file:../../icons/telegram.svg',
+            group: ['output'],
+            version: 1,
+            subtitle: '={{$parameter["responseType"]}}',
+            description: 'Ask a question in Telegram and wait for an in-chat response',
+            defaults: {
+                name: 'Telegram Advance',
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'telegramAdvanceApi',
+                    required: true,
+                },
+                {
+                    name: 'telegramAdvanceStoreApi',
+                    required: true,
+                    testedBy: 'telegramAdvanceStoreApiTest',
+                },
+            ],
+            waitingNodeTooltip: "Execution will continue after the user's Telegram response",
+            webhooks: [
+                {
+                    name: 'default',
+                    httpMethod: 'POST',
+                    responseMode: 'onReceived',
+                    responseData: '',
+                    path: '={{ $nodeId }}',
+                    restartWebhook: true,
+                    isFullPath: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Telegram Advance Trigger Required',
+                    name: 'triggerNotice',
+                    type: 'notice',
+                    default: '',
+                    description: 'Add and activate Telegram Advance Trigger in this same workflow. It receives button clicks and message replies for all waiting executions.',
+                },
+                {
+                    displayName: 'Chat ID',
+                    name: 'chatId',
+                    type: 'string',
+                    default: '={{ $json.message?.chat?.id || $json.chatId }}',
+                    required: true,
+                    description: 'Target Telegram chat ID',
+                },
+                {
+                    displayName: 'Question',
+                    name: 'question',
+                    type: 'string',
+                    typeOptions: { rows: 4 },
+                    default: '',
+                    required: true,
+                    description: 'Message shown to the Telegram user',
+                },
+                {
+                    displayName: 'Response Type',
+                    name: 'responseType',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Approval',
+                            value: 'approval',
+                            description: 'Show approve and decline buttons',
+                            action: 'Wait for approval',
+                        },
+                        {
+                            name: 'Choice',
+                            value: 'choice',
+                            description: 'Show one or more custom choices, such as products',
+                            action: 'Wait for a choice',
+                        },
+                        {
+                            name: 'Free Text',
+                            value: 'text',
+                            description: 'Ask the user to reply to the Telegram message',
+                            action: 'Wait for a text reply',
+                        },
+                    ],
+                    default: 'approval',
+                },
+                {
+                    displayName: 'Approve Label',
+                    name: 'approveLabel',
+                    type: 'string',
+                    default: '✅ Approve',
+                    displayOptions: { show: { responseType: ['approval'] } },
+                },
+                {
+                    displayName: 'Approve Value',
+                    name: 'approveValue',
+                    type: 'string',
+                    default: 'approved',
+                    displayOptions: { show: { responseType: ['approval'] } },
+                },
+                {
+                    displayName: 'Decline Label',
+                    name: 'declineLabel',
+                    type: 'string',
+                    default: '❌ Decline',
+                    displayOptions: { show: { responseType: ['approval'] } },
+                },
+                {
+                    displayName: 'Decline Value',
+                    name: 'declineValue',
+                    type: 'string',
+                    default: 'declined',
+                    displayOptions: { show: { responseType: ['approval'] } },
+                },
+                {
+                    displayName: 'Choices',
+                    name: 'choices',
+                    type: 'fixedCollection',
+                    typeOptions: { multipleValues: true },
+                    placeholder: 'Add Choice',
+                    default: {},
+                    displayOptions: { show: { responseType: ['choice'] } },
+                    options: [
+                        {
+                            displayName: 'Choice',
+                            name: 'choice',
+                            values: [
+                                {
+                                    displayName: 'Label',
+                                    name: 'label',
+                                    type: 'string',
+                                    default: '',
+                                    required: true,
+                                    description: 'Text shown on the Telegram button',
+                                },
+                                {
+                                    displayName: 'Value',
+                                    name: 'value',
+                                    type: 'string',
+                                    default: '',
+                                    required: true,
+                                    description: 'Value returned to the workflow',
+                                },
+                            ],
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Buttons Per Row',
+                    name: 'buttonsPerRow',
+                    type: 'number',
+                    typeOptions: { minValue: 1, maxValue: 8 },
+                    default: 1,
+                    displayOptions: { show: { responseType: ['approval', 'choice'] } },
+                },
+                {
+                    displayName: 'Reply Placeholder',
+                    name: 'inputPlaceholder',
+                    type: 'string',
+                    default: 'Type your answer…',
+                    displayOptions: { show: { responseType: ['text'] } },
+                    description: 'Placeholder shown in the Telegram reply field',
+                },
+                {
+                    displayName: 'Options',
+                    name: 'options',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'Acknowledgement Text',
+                            name: 'acknowledgementText',
+                            type: 'string',
+                            default: 'Response recorded',
+                            description: 'Toast shown for a button response, or message sent after a free-text response',
+                        },
+                        {
+                            displayName: 'Allowed User IDs',
+                            name: 'allowedUserIds',
+                            type: 'string',
+                            default: '',
+                            placeholder: '123456789, 987654321',
+                            description: 'Optional comma-separated Telegram user IDs. Empty allows any user in the chat.',
+                        },
+                        {
+                            displayName: 'Disable Notification',
+                            name: 'disableNotification',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to send the question silently',
+                        },
+                        {
+                            displayName: 'Parse Mode',
+                            name: 'parseMode',
+                            type: 'options',
+                            options: [
+                                { name: 'None', value: 'none' },
+                                { name: 'HTML', value: 'HTML' },
+                                { name: 'MarkdownV2', value: 'MarkdownV2' },
+                            ],
+                            default: 'none',
+                            description: 'How Telegram should parse formatting in the question',
+                        },
+                        {
+                            displayName: 'Remove Buttons After Response',
+                            name: 'removeButtons',
+                            type: 'boolean',
+                            default: true,
+                            description: 'Whether to remove inline buttons after the first response',
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Limit Wait Time',
+                    name: 'limitWaitTime',
+                    type: 'boolean',
+                    default: false,
+                    description: 'Whether to resume automatically if nobody responds',
+                },
+                {
+                    displayName: 'Wait Amount',
+                    name: 'waitAmount',
+                    type: 'number',
+                    typeOptions: { minValue: 0.1, numberPrecision: 2 },
+                    default: 1,
+                    displayOptions: { show: { limitWaitTime: [true] } },
+                },
+                {
+                    displayName: 'Wait Unit',
+                    name: 'waitUnit',
+                    type: 'options',
+                    options: [
+                        { name: 'Days', value: 'days' },
+                        { name: 'Hours', value: 'hours' },
+                        { name: 'Minutes', value: 'minutes' },
+                    ],
+                    default: 'hours',
+                    displayOptions: { show: { limitWaitTime: [true] } },
+                },
+            ],
+        };
+        this.methods = {
+            credentialTest: {
+                telegramAdvanceStoreApiTest: redisPendingStore_1.telegramAdvanceStoreApiTest,
+            },
+        };
+    }
+    async webhook() {
+        const response = this.getBodyData();
+        return {
+            webhookResponse: { ok: true },
+            workflowData: [[{ json: response }]],
+        };
+    }
+    async execute() {
+        var _a;
+        try {
+            const inputData = this.getInputData();
+            if (inputData.length === 0)
+                return [[]];
+            const chatId = String(this.getNodeParameter('chatId', 0)).trim();
+            const question = String(this.getNodeParameter('question', 0)).trim();
+            const responseType = this.getNodeParameter('responseType', 0);
+            const buttonsPerRow = this.getNodeParameter('buttonsPerRow', 0, 1);
+            const inputPlaceholder = this.getNodeParameter('inputPlaceholder', 0, '');
+            const options = this.getNodeParameter('options', 0, {});
+            if (!chatId || !question) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Chat ID and Question are required');
+            }
+            const responseOptions = (0, question_1.buildResponseOptions)(responseType, {
+                approveLabel: this.getNodeParameter('approveLabel', 0, ''),
+                approveValue: this.getNodeParameter('approveValue', 0, ''),
+                declineLabel: this.getNodeParameter('declineLabel', 0, ''),
+                declineValue: this.getNodeParameter('declineValue', 0, ''),
+                choices: this.getNodeParameter('choices', 0, {}),
+            });
+            const token = (0, crypto_1.randomBytes)(12).toString('hex');
+            const replyMarkup = (0, question_1.buildReplyMarkup)(responseType, token, responseOptions, Math.max(1, Math.min(8, buttonsPerRow)), inputPlaceholder);
+            const parseMode = String(options.parseMode || 'none');
+            const body = {
+                chat_id: chatId,
+                text: question,
+                disable_notification: options.disableNotification === true,
+                reply_markup: replyMarkup,
+            };
+            if (parseMode !== 'none')
+                body.parse_mode = parseMode;
+            const sentMessage = await (0, shared_1.telegramApiRequest)(this, 'sendMessage', body);
+            const limitWaitTime = this.getNodeParameter('limitWaitTime', 0, false);
+            const waitTill = (0, wait_1.getWaitTill)(limitWaitTime, this.getNodeParameter('waitAmount', 0, 1), this.getNodeParameter('waitUnit', 0, 'hours'));
+            const store = await (0, redisPendingStore_1.createPendingStore)(this);
+            try {
+                await store.save({
+                    token,
+                    resumeUrl: this.getSignedResumeUrl(),
+                    chatId,
+                    messageId: sentMessage.message_id,
+                    responseType,
+                    options: responseOptions,
+                    allowedUserIds: (0, question_1.parseUserIds)(options.allowedUserIds),
+                    acknowledgementText: String((_a = options.acknowledgementText) !== null && _a !== void 0 ? _a : 'Response recorded'),
+                    removeButtons: options.removeButtons !== false,
+                    createdAt: new Date().toISOString(),
+                    ...(limitWaitTime ? { expiresAt: waitTill.toISOString() } : {}),
+                });
+            }
+            finally {
+                store.close();
+            }
+            await this.putExecutionToWait(waitTill);
+            return [inputData];
+        }
+        catch (error) {
+            if (this.continueOnFail()) {
+                return [
+                    [
+                        {
+                            json: { error: error instanceof Error ? error.message : String(error) },
+                            pairedItem: { item: 0 },
+                        },
+                    ],
+                ];
+            }
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: 0 });
+        }
+    }
+}
+exports.TelegramAdvance = TelegramAdvance;
+//# sourceMappingURL=TelegramAdvance.node.js.map

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

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

package/dist/nodes/TelegramAdvance/TelegramAdvance.node.json

@@ -0,0 +1,22 @@
+{
+    "node": "@catalogicus-international/n8n-nodes-telegram-advance.telegramAdvance",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["Communication", "HITL"],
+    "subcategories": {
+        "HITL": ["Human in the Loop"]
+    },
+    "alias": ["telegram", "approval", "choice", "wait", "human", "product"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://core.telegram.org/bots/features#creating-a-new-bot"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/catalogicus-international/n8n-nodes-telegram-advance#readme"
+            }
+        ]
+    }
+}

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

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