n8n-nodes-telepath 0.0.0-stage → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## 0.1.2
+
+- Preserve empty JSON request bodies in n8n's HTTP adapter so optional-only operations such as List Telegram chats work without adding a Limit field.
+- Test OAuth credentials with an authenticated, read-only list-chats request, including accounts with an empty archive.
+
+## 0.1.1
+
+- Use the official n8n release command in GitHub Actions so the release guard and npm provenance are applied correctly.
+- First public npm release; 0.1.0 publication stopped before upload.
+
+
+## 0.1.0
+
+Initial Telepath node with 30 operations across chats, media, Notes, reminders, channels, the separate bot inbox and scoped archive deletion. Includes OAuth dynamic client registration, S256 PKCE, account-scoped authorization, request pacing and bounded rate-limit handling. Ambiguous writes are not automatically retried.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lemma Company
+
+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

@@ -1,3 +1,104 @@
-# Temporary Holding Version
+# n8n-nodes-telepath
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Connect your Telegram to n8n through [Telepath](https://telepath.lemma.company). Search your authorized archive, read messages and available voice/video-note transcripts, retrieve media, manage Notes and reminders, and perform authorized message and channel actions.
+
+Telepath is hosted: you do not need to run a Telepath server or provide Telegram API ID/hash credentials. Your own n8n instance can be n8n Cloud or self-hosted, subject to package availability.
+
+**Release:** [0.1.1 on npm](https://www.npmjs.com/package/n8n-nodes-telepath), published through GitHub Actions with provenance. The official n8n package scanner passed.
+
+**Directory status:** community integration, not yet verified by n8n. Source and examples are public. n8n Cloud installation requires directory verification; use self-hosted n8n while verification is pending.
+
+## Installation
+
+Before verification, use a self-hosted development n8n instance. Clone this repository, run `npm ci`, `npm run build`, then `npm run dev`. For local evaluation, use this source directory. Do not install an unverified package in n8n Cloud: Cloud availability requires n8n approval.
+
+After npm publication, self-hosted administrators can install `n8n-nodes-telepath` from Settings → Community Nodes. After verification, users with community nodes enabled will be able to find Telepath in the node panel.
+
+## Credentials
+
+Use a current n8n release supporting OAuth2 dynamic client registration (DCR). Node/credential loading and real DCR were checked on n8n 2.45.5. Real Telegram sign-in, chat reads, and a repeatable collection workflow were also tested. Native n8n token refresh was verified by simulating an invalid access token: n8n refreshed the credential and successfully retried the read.
+
+1. Add the Telepath node and create a **Telepath OAuth2 API** credential.
+2. Select **Connect my account** and complete Telegram sign-in in the browser. n8n registers its own OAuth client, uses S256 PKCE and refreshes tokens through its built-in OAuth2 implementation. No shared client secret or user token is bundled in this package.
+3. In Telegram, open **Settings → Chat Automation**, add **@lemma_telepath_bot**, choose your private chats and save. Menu locations vary: [device setup guide](https://telepath.lemma.company/start#telegram).
+4. Run **Chat → List Telegram chats** or **Read recent messages**. New messages arrive while collection is connected. Importing old history is optional and can be done later from a computer.
+
+Sign-in and Telegram chat collection are separate steps. An empty archive does not prove that authentication is broken. Read the response's setup guidance. If DCR options are unavailable in your n8n version, upgrade n8n; do not put a Telegram bot token in an OAuth field.
+
+The credential uses the fixed resource `https://telepath.lemma.company/mcp` and requests `telegram.read telegram.write`. Requests go only to `https://telepath.lemma.company/api/v1`. Account settings and server flags still decide which capabilities are available. Share a credential only with people authorized to access that account.
+
+## Operations
+
+| Resource | Operation | Telepath capability |
+| --- | --- | --- |
+| archive | Delete archived messages | `telegram_forget` |
+| botInbox | List bot inbox messages | `telegram_bot_direct_messages` |
+| botInbox | React in the bot inbox | `telegram_bot_dm_react` |
+| botInbox | Reply in the bot inbox | `telegram_bot_dm_reply` |
+| channel | Delete a channel post | `telegram_delete_post` |
+| channel | Edit a channel post | `telegram_edit_post` |
+| channel | Pin or unpin a channel post | `telegram_set_post_pinned` |
+| channel | Publish a channel post | `telegram_create_post` |
+| chat | Edit a sent message | `telegram_edit_message` |
+| chat | Find a chat | `telegram_find_chat` |
+| chat | List Telegram chats | `telegram_list_chats` |
+| chat | Mark a conversation read | `telegram_mark_read` |
+| chat | Read chat messages | `telegram_get_messages` |
+| chat | Read recent messages | `telegram_recent_messages` |
+| chat | Search messages | `telegram_search_messages` |
+| chat | Send a message | `telegram_send_message` |
+| chat | Set or remove a reaction | `telegram_set_reaction` |
+| media | Get an archived photo | `telegram_get_photo` |
+| media | Get multiple archived photos | `telegram_get_photos` |
+| media | Read an archived file | `telegram_get_file` |
+| media | Send a photo or document | `telegram_send_media` |
+| note | Create a note or task | `kb_create_note` |
+| note | Delete a note | `kb_delete_note` |
+| note | List notes | `kb_list_notes` |
+| note | Read a note | `kb_get_note` |
+| note | Search notes | `kb_search_notes` |
+| note | Update a note or task | `kb_update_note` |
+| reminder | Cancel a reminder | `cancel_reminder` |
+| reminder | Create a reminder | `create_reminder` |
+| reminder | List reminders | `list_reminders` |
+
+The **Get an archived photo** result includes the photo data and expiring link. It also covers the data used by ChatGPT's `telegram_show_photo`; the ChatGPT-specific display widget is not an n8n feature. This package does not administer accounts, configure Auto-reply, import exports or delete an entire account. Those are bot/setup features, not exposed MCP actions.
+
+Task reminders, media replacement when editing a channel post, albums, buttons, note tags and note types are supported. Complex values use JSON fields with schema validation. Optional fields are sent only when added; explicit `false`, `[]`, empty body strings and `null` reminders are preserved.
+
+## Limits, polling and output
+
+- REST requests share the server's **120 requests per minute per account** limit across credentials and workflows. Splitting tokens does not increase the allowance. Telegram and plan limits apply independently.
+- Within an execution, input items run sequentially with a default **1-second minimum pause** between requests. Increase **Options → Request Interval** for large batches. This pacing is local to an execution; the server enforces the shared limit.
+- The node retries HTTP 429 at most twice and honors `Retry-After`. If the requested wait exceeds 60 seconds, it stops and tells you how long to wait. A missing/invalid header uses a 60-second wait. No retry loops for permissions, expired credentials, invalid parameters or ambiguous delivery.
+- Writes are retried only for the Telepath REST gateway's explicit pre-dispatch `rate_limited` response. Telegram rate-limit responses and network/5xx errors on writes are never automatically replayed.
+- Start scheduled archive reads at **every five minutes**; see `examples/recent-message-snapshot.json`. A scheduled snapshot can contain the same messages again. It is not a guaranteed new-message trigger and does not maintain a delivery cursor. Deduplicate by chat ID + message ID before downstream actions. Narrow the chat and date range when possible.
+- Most list/search endpoints return bounded windows and do not expose a complete pagination cursor; the node does not invent a Return All option. Reminder listing supports offset pagination. Batch photo reads accept at most five message IDs.
+- Default output preserves the complete response including quota and setup guidance. **Split Results** emits array entries individually and preserves response metadata as `telepathMeta`; empty results retain the original response.
+- Media retrieval/transcription availability depends on Telegram permissions, stored file references and your account. Imported history without media does not create downloadable attachments. Reading a transcript does not initiate transcription.
+
+## Write actions
+
+Enable **Authorize Action** only after checking the intended action and targets. This authorizes the configured workflow, not an approval dialog on each scheduled run. For AI-driven actions, put n8n human approval before the write node or use tightly controlled targets. Treat chat/file/note content as untrusted data.
+
+Keep n8n's **Retry On Fail disabled for write nodes**; the node refuses writes if it is enabled, because a whole-batch retry could repeat completed actions. Verify the destination after timeouts or uncertain errors. Channel operations require `confirmed=true` and a stable `requestId`; reuse the same ID only with identical action details. Reminder creation supports the same optional idempotency key. Ordinary sends do not have an idempotency key and must not be replayed blindly, including by error workflows or a parent workflow retry.
+
+Bot inbox messages are a separate conversation from Business messages, even if chat IDs coincide. Reply through the Bot Inbox resource. Archive deletion removes only Telepath stored messages in the specified chat/date scope; it requires explicit confirmation and the account's deletion capability, and does not delete the Telegram conversation. Never enable broad deletion in an unattended workflow without defining its scope.
+
+## Examples and development
+
+- `examples/list-chats.json`: manual, read-only connection check.
+- `examples/recent-message-snapshot.json`: disabled-by-default five-minute snapshot, requiring selection of your own credential.
+- `examples/collect-chat-messages.json`: selects the first available non-channel chat, reads its latest 200 messages, and upserts rows in an n8n Data Table keyed by chat ID + message ID. Later runs keep the same chat using saved rows. The five-minute schedule is inactive until published. This bounded-window example is not guaranteed complete capture during bursts or downtime. Requires n8n Data Tables (tested on 2.45.5).
+
+Use Node.js 24 for development and CI. Run `npm ci`, `npm test`, `npm run lint` and `npm pack --dry-run`. The npm runtime package has no external dependencies beyond the n8n-provided `n8n-workflow` peer. Tests use synthetic responses and local HTTP fixtures; they do not send real Telegram messages.
+
+The node uses programmatic execution to apply safe read/write retry rules, pace item batches, validate optional structured fields and preserve setup metadata when splitting results. It uses n8n's authenticated HTTP helpers; no filesystem, environment-variable or direct network-library access occurs in the runtime node.
+
+The repository includes GitHub Actions CI and provenance publishing. Configure an npm trusted publisher for `Lemma-Company/n8n-nodes-telepath` and `publish.yml` before releasing. n8n directory review remains pending; see `RELEASE-CHECKLIST.md`.
+
+Support: https://telepath.lemma.company/support  
+Privacy: https://telepath.lemma.company/privacy  
+Terms: https://telepath.lemma.company/terms
+
+MIT © Lemma Company.

package/RELEASE-CHECKLIST.md

@@ -0,0 +1,37 @@
+# Release checklist
+
+## Implemented locally
+
+- 30 typed, allowlisted operations with no arbitrary API URL or tool dispatch.
+- OAuth2 credentials using n8n dynamic registration and S256 PKCE.
+- No bundled tokens/client secrets and no runtime dependencies beyond n8n's peer.
+- Account permissions and plan allowances remain enforced by Telepath.
+- Per-item pacing and bounded 429 handling; ambiguous writes are not replayed.
+- Write approval, scoped archive deletion, bot-inbox separation.
+- English documentation, examples, MIT, CI and provenance publishing workflow.
+
+## Verification before public submission
+
+- [x] Real n8n 2.45.5 loads Telepath, its AI-tool variant and OAuth credential (checked through its authenticated API).
+- [x] User completed setup and OAuth in the n8n editor and confirmed a successful manual run. The user also reviewed the icon; automated browser visual QA was unavailable.
+- [x] Real n8n DCR against Telepath passed after explicit approval: authorization URL, S256, scopes, canonical resource and redirect URI verified. This initial DCR-only check issued no user tokens; the later user-authorized sign-in is recorded below.
+- [x] Real Telegram sign-in and read operations passed. A collector workflow saved 200 messages into a temporary n8n table; a repeat run retained 200 unique rows. A subsequent user-run updated the same 200 rows without duplicates.
+- [x] Verify refresh using n8n's actual OAuth helper: injected an invalid access token into the isolated test credential; native refresh saved a new token and the complete read/table workflow succeeded. Temporary plaintext credential files were removed. Revoked-grant reconnect remains a manual support path.
+- [x] 30-operation REST catalog deployed; existing 25 routes preserved. Health and unauthenticated guards checked.
+- [x] Public `Lemma-Company/n8n-nodes-telepath` repository created; GitHub CI passed. npm publisher verified as `olegnikeshin`, with user-confirmed 2FA.
+- [x] Configure npm trusted publishing for `.github/workflows/publish.yml`.
+- [x] Publish version 0.1.1 from tag `v0.1.1` through GitHub Actions with provenance (run 40849007959). Version 0.1.0 stopped before upload because the workflow initially bypassed the official release command.
+- [x] Official `@n8n/scan-community-package` passed all checks for `n8n-nodes-telepath@0.1.1`, including attested source at commit `8369b69`.
+- [ ] Submit through https://creators.n8n.io/nodes and address reviewer feedback.
+
+The local tests use synthetic accounts and mocked Telegram calls. They do not prove the complete n8n browser sign-in journey or imply that n8n has approved this package. Do not mark external gates complete based only on local build/lint output.
+
+## 0.1.2 regression verification
+
+- 15 package tests pass, including optional-only POST bodies and the credential probe definition; strict lint passes.
+- 60 requests across all 30 operations pass through the actual n8n 2.45.5 HTTP adapter to a local receiver: minimum required fields and populated optional fields. JSON bodies are checked against the backend REST schemas; GET query/path mapping is checked separately.
+- Reproduce the cross-repository transport check after building both projects with:
+  `node tests/http-contract.mjs /path/to/n8n-runtime /path/to/telepath-backend`.
+  The runtime directory must contain `node_modules/@n8n/backend-network`; the backend must contain `dist/rest-catalog.js`. Test traffic stays on localhost. No user credentials are used.
+- The backend's 19 isolated REST tests pass with synthetic accounts and mocked Telegram calls.
+- This coverage verifies serialization, routing and server behavior in fixtures. Real message sends, reactions, archive deletion and channel publishing were not executed against user chats.

package/dist/credentials/TelepathOAuth2Api.credentials.d.ts

@@ -0,0 +1,13 @@
+import type { ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class TelepathOAuth2Api implements ICredentialType {
+    name: string;
+    extends: string[];
+    displayName: string;
+    documentationUrl: string;
+    icon: {
+        readonly light: "file:../nodes/Telepath/telepath.svg";
+        readonly dark: "file:../nodes/Telepath/telepath.dark.svg";
+    };
+    test: ICredentialTestRequest;
+    properties: INodeProperties[];
+}

package/dist/credentials/TelepathOAuth2Api.credentials.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelepathOAuth2Api = void 0;
+class TelepathOAuth2Api {
+    constructor() {
+        this.name = 'telepathOAuth2Api';
+        this.extends = ['oAuth2Api'];
+        this.displayName = 'Telepath OAuth2 API';
+        this.documentationUrl = 'https://github.com/Lemma-Company/n8n-nodes-telepath#credentials';
+        this.icon = { light: 'file:../nodes/Telepath/telepath.svg', dark: 'file:../nodes/Telepath/telepath.dark.svg' };
+        this.test = {
+            request: {
+                baseURL: 'https://telepath.lemma.company/api/v1',
+                url: '/chats/list',
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: { limit: 1 },
+            },
+        };
+        this.properties = [
+            { displayName: 'Use Dynamic Client Registration', name: 'useDynamicClientRegistration', type: 'hidden', default: true },
+            { displayName: 'Server URL', name: 'serverUrl', type: 'hidden', default: 'https://telepath.lemma.company/mcp' },
+            { displayName: 'Resource URL', name: 'resourceUrl', type: 'hidden', default: 'https://telepath.lemma.company/mcp' },
+            { displayName: 'Grant Type', name: 'grantType', type: 'hidden', default: 'pkce' },
+            { displayName: 'Scope', name: 'scope', type: 'hidden', default: 'telegram.read telegram.write' },
+        ];
+    }
+}
+exports.TelepathOAuth2Api = TelepathOAuth2Api;
+//# sourceMappingURL=TelepathOAuth2Api.credentials.js.map

package/dist/credentials/TelepathOAuth2Api.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelepathOAuth2Api.credentials.js","sourceRoot":"","sources":["../../credentials/TelepathOAuth2Api.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAA9B;QACE,SAAI,GAAG,mBAAmB,CAAC;QAC3B,YAAO,GAAG,CAAC,WAAW,CAAC,CAAC;QACxB,gBAAW,GAAG,qBAAqB,CAAC;QACpC,qBAAgB,GAAG,iEAAiE,CAAC;QACrF,SAAI,GAAG,EAAC,KAAK,EAAE,qCAAqC,EAAE,IAAI,EAAE,0CAA0C,EAAU,CAAC;QACjH,SAAI,GAA2B;YAC7B,OAAO,EAAE;gBACP,OAAO,EAAE,uCAAuC;gBAChD,GAAG,EAAE,aAAa;gBAClB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;aACnB;SACF,CAAC;QACF,eAAU,GAAsB;YAC9B,EAAE,WAAW,EAAE,iCAAiC,EAAE,IAAI,EAAE,8BAA8B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;YACvH,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oCAAoC,EAAE;YAC/G,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oCAAoC,EAAE;YACnH,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE;YACjF,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,8BAA8B,EAAE;SACjG,CAAC;IACJ,CAAC;CAAA;AAtBD,8CAsBC"}

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

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

package/dist/nodes/Telepath/Telepath.node.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Telepath = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const catalog_1 = require("./catalog");
+const validation_1 = require("./validation");
+const request_1 = require("./request");
+class Telepath {
+    constructor() {
+        this.description = {
+            displayName: 'Telepath', name: 'telepath', icon: { light: 'file:telepath.svg', dark: 'file:telepath.dark.svg' }, group: ['transform'], version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Search your Telegram archive and work with messages, media, Notes, reminders and channels',
+            defaults: { name: 'Telepath' }, inputs: [n8n_workflow_1.NodeConnectionTypes.Main], outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true, credentials: [{ name: 'telepathOAuth2Api', required: true }], properties: catalog_1.properties,
+        };
+    }
+    async execute() {
+        var _a;
+        const output = [];
+        const items = this.getInputData();
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+            try {
+                const resource = this.getNodeParameter('resource', itemIndex);
+                const tool = this.getNodeParameter('operation', itemIndex);
+                const op = catalog_1.operations.find(o => o.tool === tool && o.resource === resource);
+                if (!op)
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Select a supported Telepath resource and operation.');
+                if (op.write && this.getNode().retryOnFail)
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Disable Retry On Fail for write operations. Replaying a completed batch can duplicate actions.');
+                if (op.write && this.getNodeParameter('authorizeAction', itemIndex, false) !== true)
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Enable Authorize Action only after checking the action and targets.');
+                const settings = this.getNodeParameter('options', itemIndex, {});
+                const interval = Math.max(1000, Math.min(60000, Number(settings.requestInterval) || 1000));
+                if (itemIndex > 0)
+                    await (0, n8n_workflow_1.sleep)(interval);
+                const optional = this.getNodeParameter('additionalFields', itemIndex, {});
+                const args = (0, validation_1.argumentsFor)(op, name => this.getNodeParameter(name, itemIndex), optional, this.getNode());
+                const result = await (0, request_1.requestOperation)(op, args, options => this.helpers.httpRequestWithAuthentication.call(this, 'telepathOAuth2Api', options), n8n_workflow_1.sleep, this.getNode());
+                const key = ['chats', 'messages', 'notes', 'reminders', 'photos'].find(k => Array.isArray(result[k]));
+                if (settings.splitResults && key && result[key].length) {
+                    const { [key]: rows, ...meta } = result;
+                    for (const row of rows)
+                        output.push({ json: { ...row, telepathMeta: meta }, pairedItem: { item: itemIndex } });
+                }
+                else
+                    output.push({ json: result, pairedItem: { item: itemIndex } });
+            }
+            catch (error) {
+                const safe = error instanceof Error ? error.message : 'Telepath operation failed.';
+                if (this.continueOnFail()) {
+                    output.push({ json: { error: safe }, pairedItem: { item: itemIndex } });
+                    continue;
+                }
+                if (error instanceof n8n_workflow_1.NodeApiError)
+                    throw new n8n_workflow_1.NodeApiError(this.getNode(), {}, { message: safe, httpCode: (_a = error.httpCode) !== null && _a !== void 0 ? _a : undefined, itemIndex });
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), safe, { itemIndex });
+            }
+        }
+        return [output];
+    }
+}
+exports.Telepath = Telepath;
+//# sourceMappingURL=Telepath.node.js.map

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

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

package/dist/nodes/Telepath/Telepath.node.json

@@ -0,0 +1,16 @@
+{
+    "node": "n8n-nodes-telepath.telepath",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": [
+        "Communication",
+        "Productivity"
+    ],
+    "resources": {
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/Lemma-Company/n8n-nodes-telepath#readme"
+            }
+        ]
+    }
+}

package/dist/nodes/Telepath/catalog.d.ts

@@ -0,0 +1,40 @@
+import type { INodeProperties } from 'n8n-workflow';
+export interface Schema {
+    type?: string;
+    properties?: Record<string, Schema>;
+    required?: string[];
+    items?: Schema;
+    anyOf?: Schema[];
+    enum?: unknown[];
+    const?: unknown;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+    format?: string;
+    additionalProperties?: boolean;
+}
+export interface Operation {
+    tool: string;
+    resource: string;
+    path: string;
+    method: 'GET' | 'POST';
+    summary: string;
+    description: string;
+    write: boolean;
+    schema: Schema;
+    fields: Array<{
+        apiName: string;
+        name: string;
+        schema: Schema;
+        required: boolean;
+        ui: INodeProperties;
+    }>;
+}
+export declare const operations: Operation[];
+export declare const properties: INodeProperties[];

package/dist/nodes/Telepath/catalog.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.properties = exports.operations = void 0;
+const catalog_json_1 = __importDefault(require("./catalog.json"));
+exports.operations = catalog_json_1.default;
+const names = { archive: 'Archive', botInbox: 'Bot Inbox', channel: 'Channel', chat: 'Chat', media: 'Media', note: 'Note', reminder: 'Reminder' };
+const defaults = { archive: 'telegram_forget', botInbox: 'telegram_bot_direct_messages', channel: 'telegram_create_post', chat: 'telegram_list_chats', media: 'telegram_get_file', note: 'kb_list_notes', reminder: 'list_reminders' };
+exports.properties = [
+    { displayName: 'Resource', name: 'resource', type: 'options', noDataExpression: true,
+        options: Object.entries(names).map(([value, name]) => ({ name, value })), default: 'chat' },
+];
+for (const resource of Object.keys(names)) {
+    const group = exports.operations.filter(o => o.resource === resource).sort((a, b) => a.summary.localeCompare(b.summary));
+    exports.properties.push({ displayName: 'Operation', name: 'operation', type: 'options', noDataExpression: true,
+        displayOptions: { show: { resource: [resource] } },
+        options: group.map(o => ({ name: o.summary, value: o.tool, action: o.summary, description: o.description })),
+        default: '' });
+    exports.properties[exports.properties.length - 1].default = defaults[resource];
+    for (const op of group) {
+        const displayOptions = { show: { resource: [resource], operation: [op.tool] } };
+        exports.properties.push({ displayName: op.description, name: 'operationNotice', type: 'notice', default: '', displayOptions });
+        for (const field of op.fields.filter(f => f.required))
+            exports.properties.push({ ...field.ui, displayOptions });
+        const optional = op.fields.filter(f => !f.required).map(f => f.ui).sort((a, b) => a.displayName.localeCompare(b.displayName));
+        if (optional.length)
+            exports.properties.push({ displayName: 'Additional Fields', name: 'additionalFields', type: 'collection', placeholder: 'Add Field', default: {}, displayOptions, options: optional });
+        if (op.write)
+            exports.properties.push({ displayName: 'Authorize Action', name: 'authorizeAction', type: 'boolean', default: false, displayOptions,
+                description: 'Whether you authorize this workflow to perform the selected action on the specified targets. Disable Retry On Fail for write operations.' });
+    }
+}
+exports.properties.push({ displayName: 'Options', name: 'options', type: 'collection', placeholder: 'Add Option', default: {}, options: [
+        { displayName: 'Request Interval (Ms)', name: 'requestInterval', type: 'number', default: 1000, typeOptions: { minValue: 1000, maxValue: 60000, numberPrecision: 0 }, description: 'Minimum pause between requests in this execution. Other workflows share the server account limit.' },
+        { displayName: 'Split Results', name: 'splitResults', type: 'boolean', default: false, description: 'Whether to emit each chat, message, note, reminder or photo as its own item. Empty responses and setup guidance are preserved.' },
+    ] });
+//# sourceMappingURL=catalog.js.map

package/dist/nodes/Telepath/catalog.js.map

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