n8n-nodes-soniox-api 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Konstantin
+
+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,196 @@
+# n8n-nodes-soniox-api
+
+[![npm version](https://img.shields.io/npm/v/n8n-nodes-soniox-api.svg)](https://www.npmjs.com/package/n8n-nodes-soniox-api)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![n8n Community Node](https://img.shields.io/badge/n8n-Community%20Node-blue)](https://docs.n8n.io/integrations/community-nodes/)
+
+This is an n8n community node that integrates [Soniox Speech-to-Text API](https://soniox.com/) — a high-accuracy speech recognition system.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+[Installation](#installation) ·
+[Operations](#operations) ·
+[Credentials](#credentials) ·
+[Usage](#usage) ·
+[Resources](#resources)
+
+## Installation
+
+### n8n Community Nodes
+
+1. Go to **Settings → Community Nodes** in your n8n instance
+2. Click **Install** and enter: `n8n-nodes-soniox-api`
+3. Click **Install**
+4. Restart n8n to load the node
+
+### Manual Installation
+
+To get started locally, install the node in your n8n root directory:
+
+```bash
+cd ~/.n8n
+npm install n8n-nodes-soniox-api
+```
+
+For Docker-based n8n installations, add the package to your n8n installation:
+
+```bash
+docker exec -it n8n npm install n8n-nodes-soniox-api
+```
+
+### Development
+
+For local development and testing:
+
+```bash
+git clone https://github.com/mazixs/n8n-nodes-soniox-api.git
+cd n8n-nodes-soniox-api
+npm install
+npm run build
+npm link
+
+# Link to your n8n installation
+cd ~/.n8n
+npm link n8n-nodes-soniox-api
+```
+
+## Operations
+
+This node supports the following operations:
+
+### File Operations
+- **Upload** — Upload audio files (multipart/form-data support)
+- **Get** — Retrieve file by ID
+- **Get All** — List all files (with pagination)
+- **Delete** — Delete a file
+
+### Transcription Operations
+- **Create** — Create transcription with configurable parameters:
+  - Model selection
+  - Language hints
+  - Speaker diarization
+  - Non-final results
+- **Get** — Retrieve transcription result by ID
+- **Get All** — List all transcriptions (with pagination)
+
+### Model Operations
+- **Get All** — List available speech recognition models
+
+## Credentials
+
+### Setting up Credentials
+
+1. In n8n, navigate to **Credentials → Add Credential → Soniox API**
+2. Enter your credentials:
+   - **API Key**: Get your API key from [console.soniox.com](https://console.soniox.com/)
+   - **API URL**: `https://api.soniox.com/v1` (default)
+3. Click **Save**
+
+## Usage
+
+### Basic Workflow Example
+
+Here's a simple workflow to upload an audio file and transcribe it:
+
+```
+[Read Binary File] 
+    ↓
+[Soniox: File Upload]
+    ↓
+[Soniox: Transcription Create]
+    ↓
+[Soniox: Transcription Get]
+```
+
+### Node Configuration
+
+**1. Read Binary File**
+- Property Name: `data`
+- File Path: `/path/to/audio.mp3`
+
+**2. Soniox: File Upload**
+- Resource: `File`
+- Operation: `Upload`
+- Binary Property: `data`
+
+**3. Soniox: Transcription Create**
+- Resource: `Transcription`
+- Operation: `Create`
+- File ID: `{{ $json.fileId }}`
+- Model: `en_v2_lowlatency`
+
+**4. Soniox: Transcription Get**
+- Resource: `Transcription`
+- Operation: `Get`
+- Transcription ID: `{{ $json.transcriptionId }}`
+
+## Features
+
+- ✅ **Retry Logic** — Automatic retry with exponential backoff for failed requests
+- ✅ **Rate Limiting** — Smart handling of 429 responses with Retry-After headers
+- ✅ **Timeout Control** — Configurable timeouts for API and file upload operations
+- ✅ **Type Safety** — Full TypeScript implementation with n8n-workflow types
+- ✅ **Error Handling** — Comprehensive error messages for debugging
+
+## Resources
+
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [Soniox API Documentation](https://soniox.com/docs/stt/api-reference)
+- [Soniox Console](https://console.soniox.com/)
+
+## Development
+
+### Build
+
+```bash
+npm install
+npm run build
+```
+
+### Lint
+
+```bash
+npm run lint
+npm run lintfix  # Auto-fix issues
+```
+
+### Testing
+
+Link the node to your n8n installation:
+
+```bash
+npm run build && npm link
+cd ~/.n8n && npm link n8n-nodes-soniox-api
+n8n start
+```
+
+Then test the node in your n8n workflows.
+
+## Version History
+
+See [CHANGELOG.md](./CHANGELOG.md) for detailed release notes.
+
+## License
+
+[MIT](LICENSE.md)
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
+
+## Author
+
+**mazix**
+- GitHub: [@mazixs](https://github.com/mazixs)
+- npm: [n8n-nodes-soniox-api](https://www.npmjs.com/package/n8n-nodes-soniox-api)
+
+## Support
+
+If you encounter issues or have questions:
+1. Check the [documentation](./docs)
+2. Search [existing issues](https://github.com/mazixs/n8n-nodes-soniox-api/issues)
+3. Create a [new issue](https://github.com/mazixs/n8n-nodes-soniox-api/issues/new) if needed
+
+---
+
+**Made with ❤️ for the n8n community**

package/dist/credentials/SonioxApi.credentials.d.ts

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

package/dist/credentials/SonioxApi.credentials.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SonioxApi = void 0;
+class SonioxApi {
+    constructor() {
+        this.name = 'sonioxApi';
+        this.displayName = 'Soniox API';
+        this.documentationUrl = 'https://soniox.com/docs/stt/get-started';
+        this.icon = 'file:soniox.svg';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'The Soniox API key for authentication',
+            },
+            {
+                displayName: 'API URL',
+                name: 'apiUrl',
+                type: 'string',
+                default: 'https://api.soniox.com/v1',
+                description: 'The base URL for Soniox API',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'Authorization': '={{`Bearer ${$credentials.apiKey}`}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.apiUrl}}',
+                url: '/models',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.SonioxApi = SonioxApi;

package/dist/credentials/soniox.svg

@@ -0,0 +1,11 @@
+<svg viewBox="-5 -15 110 50" xmlns="http://www.w3.org/2000/svg">
+  <title>Soniox</title>
+  <g fill="#FFFFFF">
+    <path d="m0 14.866 2.1606-3.5214c1.8927 1.2576 3.9669 1.8995 5.6694 1.8995 1.0025 0 1.4606-0.3036 1.4606-0.8847v-0.0607c0-0.6419-0.9161-0.9194-2.6532-1.4138-3.2582-0.8587-5.8509-1.9602-5.8509-5.2995v-0.06938c0-3.5214 2.8088-5.4903 6.6114-5.4903 2.4112 0 4.9089 0.70255 6.8016 1.9342l-1.9791 3.6775c-1.7112-0.95408-3.5693-1.5352-4.8744-1.5352-0.88152 0-1.3396 0.33827-1.3396 0.79796v0.06071c0 0.64184 0.94202 0.95409 2.6792 1.4745 3.2582 0.91939 5.8509 2.0556 5.8509 5.2735v0.0607c0 3.6515-2.7137 5.551-6.741 5.551-2.7656-0.0087-5.5052-0.798-7.7955-2.4546z"/>
+    <path d="m16.135 8.7342v-0.06071c0-4.7184 3.8372-8.6735 9.1436-8.6735 5.2719 0 9.0832 3.8944 9.0832 8.6127v0.06072c0 4.7184-3.8372 8.6735-9.1437 8.6735-5.2718 0-9.0831-3.8944-9.0831-8.6128zm12.583 0v-0.06071c0-2.0209-1.4606-3.7383-3.5088-3.7383-2.1001 0-3.4483 1.6826-3.4483 3.6775v0.06072c0 2.0209 1.4605 3.7383 3.5088 3.7383 2.1087 0 3.4483-1.6827 3.4483-3.6776z"/>
+    <path d="m36.877 0.36428h5.7904v2.3332c1.063-1.3791 2.5927-2.6974 4.9348-2.6974 3.5089 0 5.609 2.3332 5.609 6.0974v10.85h-5.7905v-8.977c0-1.8041-0.942-2.7929-2.3161-2.7929-1.4001 0-2.4372 0.9801-2.4372 2.7929v8.977h-5.7904z"/>
+    <path d="m55.951 0.36426h5.7904v16.584h-5.7904z"/>
+    <path d="m64.29 8.7342v-0.06071c0-4.7184 3.8373-8.6735 9.1437-8.6735 5.2719 0 9.0832 3.8944 9.0832 8.6127v0.06072c0 4.7184-3.8372 8.6735-9.1437 8.6735-5.2719 0-9.0832-3.8944-9.0832-8.6128zm12.592 0v-0.06071c0-2.0209-1.4605-3.7383-3.5088-3.7383-2.1001 0-3.4483 1.6826-3.4483 3.6775v0.06072c0 2.0209 1.4606 3.7383 3.5088 3.7383 2.1088 0 3.4483-1.6827 3.4483-3.6776z"/>
+    <path d="m88.082 8.578-5.4533-8.2138h6.2484l2.4372 4.0765 2.4371-4.0765h6.1275l-5.4274 8.1791 5.5484 8.3959h-6.2225l-2.5582-4.2587-2.5927 4.2587h-6.0929z"/>
+  </g>
+</svg>

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

@@ -0,0 +1,3 @@
+import { IExecuteFunctions, IHookFunctions, ILoadOptionsFunctions, IDataObject, IHttpRequestMethods } from 'n8n-workflow';
+export declare function sonioxApiRequest(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject, uri?: string, option?: IDataObject): Promise<any>;
+export declare function sonioxApiRequestAllItems(this: IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject): Promise<any>;

package/dist/nodes/Soniox/GenericFunctions.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sonioxApiRequest = sonioxApiRequest;
+exports.sonioxApiRequestAllItems = sonioxApiRequestAllItems;
+const n8n_workflow_1 = require("n8n-workflow");
+const constants_1 = require("./constants");
+/**
+ * Задержка с exponential backoff
+ */
+async function delay(attempt) {
+    const delayMs = Math.min(constants_1.RETRY_CONFIG.BASE_DELAY * Math.pow(constants_1.RETRY_CONFIG.BACKOFF_MULTIPLIER, attempt), constants_1.RETRY_CONFIG.MAX_DELAY);
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+async function sonioxApiRequest(method, endpoint, body = {}, qs = {}, uri, option = {}) {
+    var _a, _b;
+    const credentials = await this.getCredentials('sonioxApi');
+    const options = {
+        method,
+        qs,
+        uri: uri || `${credentials.apiUrl}${endpoint}`,
+        json: true,
+        timeout: option.formData ? constants_1.TIMEOUTS.FILE_UPLOAD : constants_1.TIMEOUTS.API_REQUEST,
+    };
+    // Headers - Authorization будет добавлен через credentials.authenticate
+    options.headers = {};
+    // Handle multipart/form-data (для file upload)
+    if (option.formData) {
+        options.formData = option.formData;
+        // Content-Type устанавливается автоматически для multipart
+    }
+    else {
+        // Обычный JSON request
+        options.body = body;
+        options.headers['Content-Type'] = constants_1.CONTENT_TYPES.JSON;
+    }
+    // Retry логика с exponential backoff
+    let lastError;
+    for (let attempt = 0; attempt <= constants_1.RETRY_CONFIG.MAX_RETRIES; attempt++) {
+        try {
+            return await this.helpers.requestWithAuthentication.call(this, 'sonioxApi', options);
+        }
+        catch (error) {
+            lastError = error;
+            const statusCode = error.statusCode || ((_a = error.response) === null || _a === void 0 ? void 0 : _a.statusCode);
+            // Проверяем, нужен ли retry
+            const shouldRetry = attempt < constants_1.RETRY_CONFIG.MAX_RETRIES &&
+                (constants_1.RETRYABLE_STATUS_CODES.includes(statusCode) || error.code === 'ETIMEDOUT' || error.code === 'ECONNRESET');
+            if (!shouldRetry) {
+                break;
+            }
+            // Обработка rate limiting (429)
+            if (statusCode === 429) {
+                const retryAfter = (_b = error.response) === null || _b === void 0 ? void 0 : _b.headers['retry-after'];
+                if (retryAfter) {
+                    const waitMs = parseInt(retryAfter, 10) * 1000;
+                    await new Promise((resolve) => setTimeout(resolve, waitMs));
+                    continue;
+                }
+            }
+            // Exponential backoff для остальных ошибок
+            await delay(attempt);
+        }
+    }
+    throw new n8n_workflow_1.NodeApiError(this.getNode(), lastError);
+}
+async function sonioxApiRequestAllItems(method, endpoint, body = {}, qs = {}) {
+    const returnData = [];
+    let responseData;
+    qs.limit = constants_1.API_LIMITS.PAGINATION_LIMIT;
+    qs.offset = 0;
+    do {
+        responseData = await sonioxApiRequest.call(this, method, endpoint, body, qs);
+        returnData.push(...responseData.items);
+        qs.offset = qs.offset + qs.limit;
+    } while (responseData.items.length !== 0);
+    return returnData;
+}

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

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

package/dist/nodes/Soniox/Soniox.node.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Soniox = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const FileDescription_1 = require("./descriptions/FileDescription");
+const TranscriptionDescription_1 = require("./descriptions/TranscriptionDescription");
+const ModelDescription_1 = require("./descriptions/ModelDescription");
+const GenericFunctions_1 = require("./GenericFunctions");
+const constants_1 = require("./constants");
+class Soniox {
+    constructor() {
+        this.description = {
+            displayName: 'Soniox',
+            name: 'soniox',
+            icon: 'file:soniox.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Interact with Soniox Speech-to-Text API',
+            defaults: {
+                name: 'Soniox',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'sonioxApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'File',
+                            value: 'file',
+                        },
+                        {
+                            name: 'Model',
+                            value: 'model',
+                        },
+                        {
+                            name: 'Transcription',
+                            value: 'transcription',
+                        },
+                    ],
+                    default: 'transcription',
+                },
+                ...FileDescription_1.fileOperations,
+                ...FileDescription_1.fileFields,
+                ...TranscriptionDescription_1.transcriptionOperations,
+                ...TranscriptionDescription_1.transcriptionFields,
+                ...ModelDescription_1.modelOperations,
+                ...ModelDescription_1.modelFields,
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                if (resource === 'file') {
+                    if (operation === 'upload') {
+                        // 1. Получить параметры
+                        const binaryPropertyName = this.getNodeParameter('binaryPropertyName', i);
+                        const fileName = this.getNodeParameter('fileName', i, '');
+                        // 2. Валидация binary data
+                        const itemBinary = items[i].binary;
+                        if (!itemBinary) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'No binary data exists on input item. Please connect a node that provides binary data.', { itemIndex: i });
+                        }
+                        const binaryData = itemBinary[binaryPropertyName];
+                        if (!binaryData) {
+                            const availableProperties = Object.keys(itemBinary);
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Binary property "${binaryPropertyName}" not found. Available: ${availableProperties.join(', ')}`, { itemIndex: i });
+                        }
+                        // 3. Получить Buffer из binary data
+                        const buffer = await this.helpers.getBinaryDataBuffer(i, binaryPropertyName);
+                        // 4. Определить имя файла
+                        const uploadFileName = fileName || binaryData.fileName || 'file';
+                        // 5. Подготовить formData для multipart/form-data
+                        const formData = {
+                            file: {
+                                value: buffer,
+                                options: {
+                                    filename: uploadFileName,
+                                    contentType: binaryData.mimeType || constants_1.CONTENT_TYPES.BINARY,
+                                },
+                            },
+                        };
+                        // 6. Upload через API
+                        const response = await GenericFunctions_1.sonioxApiRequest.call(this, 'POST', '/files', {}, {}, undefined, { formData });
+                        // 7. Вернуть результат
+                        returnData.push({
+                            json: {
+                                fileId: response.file_id,
+                                fileName: uploadFileName,
+                                mimeType: binaryData.mimeType,
+                                fileSize: binaryData.fileSize,
+                                uploadedAt: new Date().toISOString(),
+                            },
+                        });
+                    }
+                    else if (operation === 'get') {
+                        const fileId = this.getNodeParameter('fileId', i);
+                        const response = await GenericFunctions_1.sonioxApiRequest.call(this, 'GET', `/files/${fileId}`);
+                        returnData.push({ json: response });
+                    }
+                    else if (operation === 'getAll') {
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        let responseData;
+                        if (returnAll) {
+                            responseData = await GenericFunctions_1.sonioxApiRequestAllItems.call(this, 'GET', '/files');
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            responseData = await GenericFunctions_1.sonioxApiRequest.call(this, 'GET', '/files', {}, { limit });
+                        }
+                        const fileItems = Array.isArray(responseData) ? responseData : responseData.items || [];
+                        fileItems.forEach((item) => {
+                            returnData.push({ json: item });
+                        });
+                    }
+                    else if (operation === 'delete') {
+                        const fileId = this.getNodeParameter('fileId', i);
+                        await GenericFunctions_1.sonioxApiRequest.call(this, 'DELETE', `/files/${fileId}`);
+                        returnData.push({
+                            json: {
+                                success: true,
+                                fileId,
+                            },
+                        });
+                    }
+                }
+                else if (resource === 'transcription') {
+                    if (operation === 'create') {
+                        const fileId = this.getNodeParameter('fileId', i);
+                        const model = this.getNodeParameter('model', i, '');
+                        const additionalFields = this.getNodeParameter('additionalFields', i, {});
+                        const body = {
+                            file_id: fileId,
+                        };
+                        if (model) {
+                            body.model = model;
+                        }
+                        if (additionalFields.language) {
+                            body.language = additionalFields.language;
+                        }
+                        if (additionalFields.enableSpeakerDiarization) {
+                            body.enable_speaker_diarization = additionalFields.enableSpeakerDiarization;
+                        }
+                        if (additionalFields.includeNonFinal) {
+                            body.include_nonfinal = additionalFields.includeNonFinal;
+                        }
+                        const response = await GenericFunctions_1.sonioxApiRequest.call(this, 'POST', '/transcriptions', body);
+                        returnData.push({ json: response });
+                    }
+                    else if (operation === 'get') {
+                        const transcriptionId = this.getNodeParameter('transcriptionId', i);
+                        const response = await GenericFunctions_1.sonioxApiRequest.call(this, 'GET', `/transcriptions/${transcriptionId}`);
+                        returnData.push({ json: response });
+                    }
+                    else if (operation === 'getAll') {
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        let responseData;
+                        if (returnAll) {
+                            responseData = await GenericFunctions_1.sonioxApiRequestAllItems.call(this, 'GET', '/transcriptions');
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            responseData = await GenericFunctions_1.sonioxApiRequest.call(this, 'GET', '/transcriptions', {}, { limit });
+                        }
+                        const transcriptionItems = Array.isArray(responseData) ? responseData : responseData.items || [];
+                        transcriptionItems.forEach((item) => {
+                            returnData.push({ json: item });
+                        });
+                    }
+                }
+                else if (resource === 'model') {
+                    if (operation === 'getAll') {
+                        const response = await GenericFunctions_1.sonioxApiRequest.call(this, 'GET', '/models');
+                        const models = Array.isArray(response) ? response : response.models || [];
+                        models.forEach((model) => {
+                            returnData.push({ json: model });
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message } });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Soniox = Soniox;

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

@@ -0,0 +1,48 @@
+/**
+ * Константы для Soniox API
+ */
+/**
+ * Лимиты API
+ */
+export declare const API_LIMITS: {
+    /** Максимальное количество элементов на запрос */
+    MAX_ITEMS_PER_REQUEST: number;
+    /** Количество элементов по умолчанию */
+    DEFAULT_LIMIT: number;
+    /** Лимит для пагинации */
+    PAGINATION_LIMIT: number;
+};
+/**
+ * MIME типы
+ */
+export declare const CONTENT_TYPES: {
+    JSON: string;
+    BINARY: string;
+    FORM_DATA: string;
+};
+/**
+ * Настройки retry для API запросов
+ */
+export declare const RETRY_CONFIG: {
+    /** Максимальное количество попыток */
+    MAX_RETRIES: number;
+    /** Базовая задержка в мс */
+    BASE_DELAY: number;
+    /** Максимальная задержка в мс */
+    MAX_DELAY: number;
+    /** Множитель для exponential backoff */
+    BACKOFF_MULTIPLIER: number;
+};
+/**
+ * Таймауты
+ */
+export declare const TIMEOUTS: {
+    /** Таймаут для API запросов в мс */
+    API_REQUEST: number;
+    /** Таймаут для загрузки файлов в мс */
+    FILE_UPLOAD: number;
+};
+/**
+ * HTTP коды статуса, которые требуют retry
+ */
+export declare const RETRYABLE_STATUS_CODES: number[];

package/dist/nodes/Soniox/constants.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Константы для Soniox API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RETRYABLE_STATUS_CODES = exports.TIMEOUTS = exports.RETRY_CONFIG = exports.CONTENT_TYPES = exports.API_LIMITS = void 0;
+/**
+ * Лимиты API
+ */
+exports.API_LIMITS = {
+    /** Максимальное количество элементов на запрос */
+    MAX_ITEMS_PER_REQUEST: 100,
+    /** Количество элементов по умолчанию */
+    DEFAULT_LIMIT: 50,
+    /** Лимит для пагинации */
+    PAGINATION_LIMIT: 100,
+};
+/**
+ * MIME типы
+ */
+exports.CONTENT_TYPES = {
+    JSON: 'application/json',
+    BINARY: 'application/octet-stream',
+    FORM_DATA: 'multipart/form-data',
+};
+/**
+ * Настройки retry для API запросов
+ */
+exports.RETRY_CONFIG = {
+    /** Максимальное количество попыток */
+    MAX_RETRIES: 3,
+    /** Базовая задержка в мс */
+    BASE_DELAY: 1000,
+    /** Максимальная задержка в мс */
+    MAX_DELAY: 10000,
+    /** Множитель для exponential backoff */
+    BACKOFF_MULTIPLIER: 2,
+};
+/**
+ * Таймауты
+ */
+exports.TIMEOUTS = {
+    /** Таймаут для API запросов в мс */
+    API_REQUEST: 30000,
+    /** Таймаут для загрузки файлов в мс */
+    FILE_UPLOAD: 60000,
+};
+/**
+ * HTTP коды статуса, которые требуют retry
+ */
+exports.RETRYABLE_STATUS_CODES = [408, 429, 500, 502, 503, 504];

package/dist/nodes/Soniox/descriptions/FileDescription.d.ts

@@ -0,0 +1,3 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const fileOperations: INodeProperties[];
+export declare const fileFields: INodeProperties[];

package/dist/nodes/Soniox/descriptions/FileDescription.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileFields = exports.fileOperations = void 0;
+const constants_1 = require("../constants");
+exports.fileOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['file'],
+            },
+        },
+        options: [
+            {
+                name: 'Upload',
+                value: 'upload',
+                description: 'Upload an audio file',
+                action: 'Upload a file',
+            },
+            {
+                name: 'Get',
+                value: 'get',
+                description: 'Get a file by ID',
+                action: 'Get a file',
+            },
+            {
+                name: 'Get All',
+                value: 'getAll',
+                description: 'Get all files',
+                action: 'Get all files',
+            },
+            {
+                name: 'Delete',
+                value: 'delete',
+                description: 'Delete a file',
+                action: 'Delete a file',
+            },
+        ],
+        default: 'upload',
+    },
+];
+exports.fileFields = [
+    // Upload operation
+    {
+        displayName: 'Binary Property',
+        name: 'binaryPropertyName',
+        type: 'string',
+        default: 'data',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['file'],
+                operation: ['upload'],
+            },
+        },
+        description: 'Name of the binary property containing the file',
+    },
+    {
+        displayName: 'File Name',
+        name: 'fileName',
+        type: 'string',
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['file'],
+                operation: ['upload'],
+            },
+        },
+        description: 'Name of the file to upload',
+    },
+    // Get/Delete operations
+    {
+        displayName: 'File ID',
+        name: 'fileId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['file'],
+                operation: ['get', 'delete'],
+            },
+        },
+        description: 'The ID of the file',
+    },
+    // Get All operation
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['file'],
+                operation: ['getAll'],
+            },
+        },
+        default: false,
+        description: 'Whether to return all results or only up to a given limit',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        displayOptions: {
+            show: {
+                resource: ['file'],
+                operation: ['getAll'],
+                returnAll: [false],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+            maxValue: constants_1.API_LIMITS.MAX_ITEMS_PER_REQUEST,
+        },
+        default: constants_1.API_LIMITS.DEFAULT_LIMIT,
+        description: 'Max number of results to return',
+    },
+];

package/dist/nodes/Soniox/descriptions/ModelDescription.d.ts

@@ -0,0 +1,3 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const modelOperations: INodeProperties[];
+export declare const modelFields: INodeProperties[];

package/dist/nodes/Soniox/descriptions/ModelDescription.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.modelFields = exports.modelOperations = void 0;
+exports.modelOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['model'],
+            },
+        },
+        options: [
+            {
+                name: 'Get All',
+                value: 'getAll',
+                description: 'Get all available models',
+                action: 'Get all models',
+            },
+        ],
+        default: 'getAll',
+    },
+];
+exports.modelFields = [];

package/dist/nodes/Soniox/descriptions/TranscriptionDescription.d.ts

@@ -0,0 +1,3 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const transcriptionOperations: INodeProperties[];
+export declare const transcriptionFields: INodeProperties[];

package/dist/nodes/Soniox/descriptions/TranscriptionDescription.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transcriptionFields = exports.transcriptionOperations = void 0;
+const constants_1 = require("../constants");
+exports.transcriptionOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['transcription'],
+            },
+        },
+        options: [
+            {
+                name: 'Create',
+                value: 'create',
+                description: 'Create a transcription',
+                action: 'Create a transcription',
+            },
+            {
+                name: 'Get',
+                value: 'get',
+                description: 'Get a transcription',
+                action: 'Get a transcription',
+            },
+            {
+                name: 'Get All',
+                value: 'getAll',
+                description: 'Get all transcriptions',
+                action: 'Get all transcriptions',
+            },
+        ],
+        default: 'create',
+    },
+];
+exports.transcriptionFields = [
+    // Create operation
+    {
+        displayName: 'File ID',
+        name: 'fileId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['transcription'],
+                operation: ['create'],
+            },
+        },
+        description: 'The ID of the file to transcribe',
+    },
+    {
+        displayName: 'Model',
+        name: 'model',
+        type: 'string',
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['transcription'],
+                operation: ['create'],
+            },
+        },
+        description: 'The model to use for transcription',
+        placeholder: 'e.g., en_v2_lowlatency',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['transcription'],
+                operation: ['create'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Language',
+                name: 'language',
+                type: 'string',
+                default: '',
+                description: 'Language code (e.g., en, es, fr)',
+            },
+            {
+                displayName: 'Enable Speaker Diarization',
+                name: 'enableSpeakerDiarization',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to enable speaker diarization',
+            },
+            {
+                displayName: 'Include Non-Final',
+                name: 'includeNonFinal',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to include non-final results',
+            },
+        ],
+    },
+    // Get operation
+    {
+        displayName: 'Transcription ID',
+        name: 'transcriptionId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['transcription'],
+                operation: ['get'],
+            },
+        },
+        description: 'The ID of the transcription',
+    },
+    // Get All operation
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['transcription'],
+                operation: ['getAll'],
+            },
+        },
+        default: false,
+        description: 'Whether to return all results or only up to a given limit',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        displayOptions: {
+            show: {
+                resource: ['transcription'],
+                operation: ['getAll'],
+                returnAll: [false],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+            maxValue: constants_1.API_LIMITS.MAX_ITEMS_PER_REQUEST,
+        },
+        default: constants_1.API_LIMITS.DEFAULT_LIMIT,
+        description: 'Max number of results to return',
+    },
+];

package/dist/nodes/Soniox/soniox.svg

@@ -0,0 +1,11 @@
+<svg viewBox="-5 -15 110 50" xmlns="http://www.w3.org/2000/svg">
+  <title>Soniox</title>
+  <g fill="#FFFFFF">
+    <path d="m0 14.866 2.1606-3.5214c1.8927 1.2576 3.9669 1.8995 5.6694 1.8995 1.0025 0 1.4606-0.3036 1.4606-0.8847v-0.0607c0-0.6419-0.9161-0.9194-2.6532-1.4138-3.2582-0.8587-5.8509-1.9602-5.8509-5.2995v-0.06938c0-3.5214 2.8088-5.4903 6.6114-5.4903 2.4112 0 4.9089 0.70255 6.8016 1.9342l-1.9791 3.6775c-1.7112-0.95408-3.5693-1.5352-4.8744-1.5352-0.88152 0-1.3396 0.33827-1.3396 0.79796v0.06071c0 0.64184 0.94202 0.95409 2.6792 1.4745 3.2582 0.91939 5.8509 2.0556 5.8509 5.2735v0.0607c0 3.6515-2.7137 5.551-6.741 5.551-2.7656-0.0087-5.5052-0.798-7.7955-2.4546z"/>
+    <path d="m16.135 8.7342v-0.06071c0-4.7184 3.8372-8.6735 9.1436-8.6735 5.2719 0 9.0832 3.8944 9.0832 8.6127v0.06072c0 4.7184-3.8372 8.6735-9.1437 8.6735-5.2718 0-9.0831-3.8944-9.0831-8.6128zm12.583 0v-0.06071c0-2.0209-1.4606-3.7383-3.5088-3.7383-2.1001 0-3.4483 1.6826-3.4483 3.6775v0.06072c0 2.0209 1.4605 3.7383 3.5088 3.7383 2.1087 0 3.4483-1.6827 3.4483-3.6776z"/>
+    <path d="m36.877 0.36428h5.7904v2.3332c1.063-1.3791 2.5927-2.6974 4.9348-2.6974 3.5089 0 5.609 2.3332 5.609 6.0974v10.85h-5.7905v-8.977c0-1.8041-0.942-2.7929-2.3161-2.7929-1.4001 0-2.4372 0.9801-2.4372 2.7929v8.977h-5.7904z"/>
+    <path d="m55.951 0.36426h5.7904v16.584h-5.7904z"/>
+    <path d="m64.29 8.7342v-0.06071c0-4.7184 3.8373-8.6735 9.1437-8.6735 5.2719 0 9.0832 3.8944 9.0832 8.6127v0.06072c0 4.7184-3.8372 8.6735-9.1437 8.6735-5.2719 0-9.0832-3.8944-9.0832-8.6128zm12.592 0v-0.06071c0-2.0209-1.4605-3.7383-3.5088-3.7383-2.1001 0-3.4483 1.6826-3.4483 3.6775v0.06072c0 2.0209 1.4606 3.7383 3.5088 3.7383 2.1088 0 3.4483-1.6827 3.4483-3.6776z"/>
+    <path d="m88.082 8.578-5.4533-8.2138h6.2484l2.4372 4.0765 2.4371-4.0765h6.1275l-5.4274 8.1791 5.5484 8.3959h-6.2225l-2.5582-4.2587-2.5927 4.2587h-6.0929z"/>
+  </g>
+</svg>

package/index.js

@@ -0,0 +1,2 @@
+// This file is intentionally empty.
+// n8n will load the nodes from the paths specified in package.json

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "n8n-nodes-soniox-api",
+  "version": "0.2.0",
+  "description": "n8n node for Soniox Speech-to-Text API",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "lint": "eslint nodes credentials --ext .ts",
+    "lintfix": "eslint nodes credentials --ext .ts --fix",
+    "prepublishOnly": "npm run build && npm run lint"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/SonioxApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Soniox/Soniox.node.js"
+    ]
+  },
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "soniox",
+    "speech-to-text",
+    "transcription",
+    "audio",
+    "voice-recognition",
+    "stt",
+    "asr",
+    "workflow-automation"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/mazixs/n8n-nodes-soniox-api",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mazixs/n8n-nodes-soniox-api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mazixs/n8n-nodes-soniox-api/issues"
+  },
+  "author": {
+    "name": "mazix",
+    "email": "mazix@bk.ru"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.9.0",
+    "n8n-workflow": "^1.112.0",
+    "n8n-core": "^1.113.0",
+    "gulp": "^5.0.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "overrides": {
+    "form-data": "^4.0.4"
+  }
+}