n8n-nodes-datatable-manager-select 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Thomas Braun
+
+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,432 @@
+# n8n-nodes-datatable-manager-select
+
+Ein n8n Community Node zur Verwaltung von internen Data Tables mit benutzerfreundlicher Namensauswahl per Dropdown.
+
+An n8n community node for managing internal Data Tables with user-friendly name-based dropdown selection.
+
+---
+
+## Inhaltsverzeichnis / Table of Contents
+
+- [Deutsch](#deutsch)
+  - [Beschreibung](#beschreibung)
+  - [Features](#features)
+  - [Installation](#installation)
+  - [Verwendung](#verwendung)
+  - [Screenshots](#screenshots)
+  - [Beispiele](#beispiele)
+- [English](#english)
+  - [Description](#description)
+  - [Features](#features-1)
+  - [Installation](#installation-1)
+  - [Usage](#usage)
+  - [Screenshots](#screenshots-1)
+  - [Examples](#examples)
+- [License](#license)
+
+---
+
+# Deutsch
+
+## Beschreibung
+
+Dieser n8n Community Node ermoeglicht die vollstaendige Verwaltung von n8n internen Data Tables direkt aus Ihren Workflows heraus. Im Gegensatz zur Standard-Version werden Tabellen und Spalten ueber benutzerfreundliche Dropdown-Menues mit Namen ausgewaehlt - keine manuelle Eingabe von IDs mehr erforderlich!
+
+### Hauptvorteile gegenueber der Basis-Version:
+
+- **Namensbasierte Auswahl**: Waehlen Sie Tabellen und Spalten aus Dropdown-Listen statt IDs einzugeben
+- **Dynamisches Laden**: Die verfuegbaren Optionen werden live aus Ihrer n8n-Instanz geladen
+- **Fehlerreduzierung**: Keine Tippfehler bei IDs mehr moeglich
+- **Bessere Uebersicht**: Sehen Sie sofort alle verfuegbaren Tabellen und Spalten
+
+## Features
+
+### Tabellen-Operationen
+- **Create**: Neue Data Tables mit benutzerdefinierten Spalten erstellen
+- **Get All**: Alle vorhandenen Data Tables auflisten
+- **Update**: Tabellen umbenennen (Auswahl per Dropdown)
+- **Delete**: Tabellen loeschen (Auswahl per Dropdown)
+
+### Spalten-Operationen
+- **Add**: Neue Spalten zu bestehenden Tabellen hinzufuegen
+- **Get All**: Alle Spalten einer Tabelle auflisten
+- **Rename**: Spalten umbenennen (Auswahl per Dropdown)
+- **Delete**: Spalten loeschen (Auswahl per Dropdown)
+
+### Unterstuetzte Spaltentypen
+- String (Text)
+- Number (Zahl)
+- Boolean (Ja/Nein)
+- Date (Datum)
+
+## Installation
+
+### Ueber die n8n Community Nodes (empfohlen)
+
+1. Oeffnen Sie n8n
+2. Gehen Sie zu **Settings** > **Community Nodes**
+3. Klicken Sie auf **Install**
+4. Geben Sie ein: `n8n-nodes-datatable-manager-select`
+5. Klicken Sie auf **Install**
+6. Starten Sie n8n neu
+
+### Manuelle Installation
+
+```bash
+# Navigieren Sie zum n8n-Installationsverzeichnis
+cd ~/.n8n
+
+# Erstellen Sie den custom-Ordner falls nicht vorhanden
+mkdir -p custom
+
+# Installieren Sie den Node
+npm install n8n-nodes-datatable-manager-select
+
+# Starten Sie n8n neu
+```
+
+### Docker
+
+Fuegen Sie das Paket zu Ihrer Docker-Konfiguration hinzu:
+
+```yaml
+environment:
+  - N8N_CUSTOM_EXTENSIONS=n8n-nodes-datatable-manager-select
+```
+
+Oder installieren Sie es im laufenden Container:
+
+```bash
+docker exec -it n8n npm install n8n-nodes-datatable-manager-select
+docker restart n8n
+```
+
+## Verwendung
+
+### Verbindungseinstellungen
+
+Jeder Node benoetigt folgende Einstellungen:
+
+| Parameter | Beschreibung | Beispiel |
+|-----------|-------------|----------|
+| Base URL | Die URL Ihrer n8n-Instanz | `http://localhost:5678` |
+| Email | Ihr n8n Login-Email | `admin@example.com` |
+| Password | Ihr n8n Login-Passwort | `********` |
+
+### Tabelle erstellen
+
+1. Waehlen Sie **Resource**: Table
+2. Waehlen Sie **Operation**: Create
+3. Geben Sie den **Table Name** ein
+4. Fuegen Sie Spalten hinzu (optional)
+   - Column Name: Name der Spalte
+   - Column Type: String, Number, Boolean oder Date
+
+### Tabelle aktualisieren/loeschen
+
+1. Waehlen Sie **Resource**: Table
+2. Waehlen Sie **Operation**: Update oder Delete
+3. **Waehlen Sie die Tabelle aus dem Dropdown** - hier werden alle verfuegbaren Tabellen angezeigt!
+4. Bei Update: Geben Sie den neuen Namen ein
+
+### Spalte hinzufuegen
+
+1. Waehlen Sie **Resource**: Column
+2. Waehlen Sie **Operation**: Add
+3. **Waehlen Sie die Tabelle aus dem Dropdown**
+4. Geben Sie den Spaltennamen und -typ ein
+
+### Spalte umbenennen/loeschen
+
+1. Waehlen Sie **Resource**: Column
+2. Waehlen Sie **Operation**: Rename oder Delete
+3. **Waehlen Sie die Tabelle aus dem Dropdown**
+4. **Waehlen Sie die Spalte aus dem Dropdown** - hier werden alle Spalten der gewaehlten Tabelle angezeigt!
+5. Bei Rename: Geben Sie den neuen Namen ein
+
+## Screenshots
+
+### Node-Uebersicht
+[Screenshot: Der Data Table Manager Node in der n8n Node-Palette mit dem charakteristischen Tabellen-Icon]
+
+### Tabellen-Dropdown
+[Screenshot: Das Dropdown-Menue zur Tabellenauswahl zeigt alle verfuegbaren Tabellen mit ihren Namen an]
+
+### Spalten-Dropdown
+[Screenshot: Nach Auswahl einer Tabelle zeigt das Spalten-Dropdown alle verfuegbaren Spalten mit Namen und Typ an]
+
+### Tabelle erstellen
+[Screenshot: Das Formular zum Erstellen einer neuen Tabelle mit Spalten-Definition]
+
+### Workflow-Beispiel
+[Screenshot: Ein kompletter Workflow der mehrere Data Table Manager Nodes verwendet]
+
+## Beispiele
+
+### Beispiel 1: Dynamische Tabellenerstellung
+
+Erstellen Sie eine Tabelle mit Kundendaten:
+
+```
+Resource: Table
+Operation: Create
+Table Name: Customers
+Columns:
+  - name: customer_id, type: string
+  - name: email, type: string
+  - name: created_at, type: date
+  - name: is_active, type: boolean
+```
+
+### Beispiel 2: Spalte zu bestehender Tabelle hinzufuegen
+
+```
+Resource: Column
+Operation: Add
+Table: [Waehlen Sie "Customers" aus dem Dropdown]
+Column Name: phone_number
+Column Type: String
+```
+
+### Beispiel 3: Tabelle umbenennen
+
+```
+Resource: Table
+Operation: Update
+Table: [Waehlen Sie die Tabelle aus dem Dropdown]
+New Table Name: Archived_Customers
+```
+
+### Beispiel 4: Alle Tabellen auflisten
+
+```
+Resource: Table
+Operation: Get All
+```
+
+Gibt ein Array aller Tabellen mit ID, Name und Metadaten zurueck.
+
+---
+
+# English
+
+## Description
+
+This n8n community node enables complete management of n8n internal Data Tables directly from your workflows. Unlike the standard version, tables and columns are selected via user-friendly dropdown menus with names - no more manual ID entry required!
+
+### Key advantages over the base version:
+
+- **Name-based selection**: Select tables and columns from dropdown lists instead of entering IDs
+- **Dynamic loading**: Available options are loaded live from your n8n instance
+- **Error reduction**: No more typos in IDs
+- **Better overview**: See all available tables and columns at a glance
+
+## Features
+
+### Table Operations
+- **Create**: Create new Data Tables with custom columns
+- **Get All**: List all existing Data Tables
+- **Update**: Rename tables (selection via dropdown)
+- **Delete**: Delete tables (selection via dropdown)
+
+### Column Operations
+- **Add**: Add new columns to existing tables
+- **Get All**: List all columns of a table
+- **Rename**: Rename columns (selection via dropdown)
+- **Delete**: Delete columns (selection via dropdown)
+
+### Supported Column Types
+- String (Text)
+- Number
+- Boolean (Yes/No)
+- Date
+
+## Installation
+
+### Via n8n Community Nodes (recommended)
+
+1. Open n8n
+2. Go to **Settings** > **Community Nodes**
+3. Click **Install**
+4. Enter: `n8n-nodes-datatable-manager-select`
+5. Click **Install**
+6. Restart n8n
+
+### Manual Installation
+
+```bash
+# Navigate to n8n installation directory
+cd ~/.n8n
+
+# Create custom folder if not exists
+mkdir -p custom
+
+# Install the node
+npm install n8n-nodes-datatable-manager-select
+
+# Restart n8n
+```
+
+### Docker
+
+Add the package to your Docker configuration:
+
+```yaml
+environment:
+  - N8N_CUSTOM_EXTENSIONS=n8n-nodes-datatable-manager-select
+```
+
+Or install in running container:
+
+```bash
+docker exec -it n8n npm install n8n-nodes-datatable-manager-select
+docker restart n8n
+```
+
+## Usage
+
+### Connection Settings
+
+Each node requires the following settings:
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| Base URL | The URL of your n8n instance | `http://localhost:5678` |
+| Email | Your n8n login email | `admin@example.com` |
+| Password | Your n8n login password | `********` |
+
+### Create Table
+
+1. Select **Resource**: Table
+2. Select **Operation**: Create
+3. Enter the **Table Name**
+4. Add columns (optional)
+   - Column Name: Name of the column
+   - Column Type: String, Number, Boolean or Date
+
+### Update/Delete Table
+
+1. Select **Resource**: Table
+2. Select **Operation**: Update or Delete
+3. **Select the table from the dropdown** - all available tables are displayed here!
+4. For Update: Enter the new name
+
+### Add Column
+
+1. Select **Resource**: Column
+2. Select **Operation**: Add
+3. **Select the table from the dropdown**
+4. Enter the column name and type
+
+### Rename/Delete Column
+
+1. Select **Resource**: Column
+2. Select **Operation**: Rename or Delete
+3. **Select the table from the dropdown**
+4. **Select the column from the dropdown** - all columns of the selected table are displayed here!
+5. For Rename: Enter the new name
+
+## Screenshots
+
+### Node Overview
+[Screenshot: The Data Table Manager node in the n8n node palette with its characteristic table icon]
+
+### Table Dropdown
+[Screenshot: The dropdown menu for table selection shows all available tables with their names]
+
+### Column Dropdown
+[Screenshot: After selecting a table, the column dropdown shows all available columns with name and type]
+
+### Create Table
+[Screenshot: The form for creating a new table with column definition]
+
+### Workflow Example
+[Screenshot: A complete workflow using multiple Data Table Manager nodes]
+
+## Examples
+
+### Example 1: Dynamic Table Creation
+
+Create a table with customer data:
+
+```
+Resource: Table
+Operation: Create
+Table Name: Customers
+Columns:
+  - name: customer_id, type: string
+  - name: email, type: string
+  - name: created_at, type: date
+  - name: is_active, type: boolean
+```
+
+### Example 2: Add Column to Existing Table
+
+```
+Resource: Column
+Operation: Add
+Table: [Select "Customers" from dropdown]
+Column Name: phone_number
+Column Type: String
+```
+
+### Example 3: Rename Table
+
+```
+Resource: Table
+Operation: Update
+Table: [Select table from dropdown]
+New Table Name: Archived_Customers
+```
+
+### Example 4: List All Tables
+
+```
+Resource: Table
+Operation: Get All
+```
+
+Returns an array of all tables with ID, name and metadata.
+
+---
+
+## Kompatibilitaet / Compatibility
+
+- n8n Version: >= 1.0.0
+- Node.js: >= 18.0.0
+
+## Bekannte Einschraenkungen / Known Limitations
+
+- Die Dropdown-Optionen erfordern eine erfolgreiche Verbindung zu Ihrer n8n-Instanz
+- Bei vielen Tabellen/Spalten kann das Laden der Optionen einen Moment dauern
+- The dropdown options require a successful connection to your n8n instance
+- With many tables/columns, loading options may take a moment
+
+## Support
+
+Bei Fragen oder Problemen erstellen Sie bitte einen Issue.
+For questions or issues, please create an issue.
+
+## License
+
+MIT License
+
+Copyright (c) 2024 Thomas Braun
+
+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/dist/credentials/DataTableManagerApi.credentials.d.ts

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

package/dist/credentials/DataTableManagerApi.credentials.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataTableManagerApi = void 0;
+class DataTableManagerApi {
+    name = 'dataTableManagerApi';
+    displayName = 'Data Table Manager API';
+    documentationUrl = 'https://docs.n8n.io/data/data-tables/';
+    properties = [
+        {
+            displayName: 'Base URL',
+            name: 'baseUrl',
+            type: 'string',
+            default: 'http://localhost:5678',
+            placeholder: 'http://localhost:5678',
+            description: 'Die Base URL deiner n8n Instanz',
+            required: true,
+        },
+        {
+            displayName: 'Email',
+            name: 'email',
+            type: 'string',
+            default: '',
+            placeholder: 'admin@example.com',
+            description: 'Deine n8n Login Email',
+            required: true,
+        },
+        {
+            displayName: 'Password',
+            name: 'password',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            description: 'Dein n8n Login Passwort',
+            required: true,
+        },
+    ];
+}
+exports.DataTableManagerApi = DataTableManagerApi;

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

@@ -0,0 +1,36 @@
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+/**
+ * Data Table Manager Node with Dropdown Selection
+ *
+ * This node uses a CREDENTIALS-based approach for authentication.
+ * This is the KEY FIX for the loadOptions problem:
+ *
+ * PROBLEM: getNodeParameter() and getCurrentNodeParameter() in loadOptions
+ * only work for SAVED parameter values. When a user enters credentials
+ * but hasn't executed the node yet, these methods return empty strings.
+ *
+ * SOLUTION: Use this.getCredentials() instead. n8n's credential system
+ * properly provides credential values to loadOptions even before the
+ * node is executed, because credentials are saved separately and
+ * immediately available once the user selects/creates them.
+ */
+export declare class DataTableManager implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            /**
+             * Load available tables as dropdown options.
+             *
+             * KEY FIX: Uses this.getCredentials() instead of this.getNodeParameter()
+             * This allows the dropdown to work IMMEDIATELY after credentials are selected,
+             * without needing to execute the node first.
+             */
+            getTables(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            /**
+             * Load available columns for selected table as dropdown options.
+             */
+            getColumns(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}