@jep182/n8n-nodes-whatsthat 0.2.0 → 0.3.0

package/README.md

@@ -73,8 +73,7 @@ Use this node to listen for:
 WhatsThat embeds Baileys directly in n8n.
 
 - session auth files are stored on disk
-- session metadata and linked targets can use n8n Data Tables when available
-- if Data Tables are not available, WhatsThat falls back to local JSON storage
+- session metadata and linked targets are stored as local JSON files under the runtime storage path
 
 ## Quick Start
 
@@ -87,9 +86,9 @@ WhatsThat embeds Baileys directly in n8n.
 
 3. Add `WhatsThat Session`.
 4. Choose `Create Session`, then provide:
-   - `Session ID`
-   - `Label`
-   - optional `Phone Number For Pairing`
+   - `Session ID (Internal)`: a stable unique ID such as `main-phone`
+   - `Label (Visible Name)`: a human-readable name such as `Luca personal phone`
+   - optional `Phone Number For Pairing`: full number with country code, digits only, without `00` or `+`
 5. Run `Connect Session`.
 6. Use the returned `pairingCode` or `qrDataUrl` to connect the device.
 7. Use `WhatsThat Targets` to discover and link chats/groups.

package/dist/credentials/WhatsThatRuntime.credentials.js

@@ -5,7 +5,7 @@ class WhatsThatRuntime {
     constructor() {
         this.name = 'whatsThatRuntime';
         this.displayName = 'WhatsThat Runtime';
-        this.documentationUrl = 'https://github.com/jep182/whatsapp-bot';
+        this.documentationUrl = 'https://github.com/jepgambardella/n8n-nodes-whatsthat';
         this.properties = [
             {
                 displayName: 'Storage Path',
@@ -13,14 +13,7 @@ class WhatsThatRuntime {
                 type: 'string',
                 default: '=/home/node/.n8n/whatsthat',
                 required: true,
-                description: 'Root folder used for session files and local fallback data',
-            },
-            {
-                displayName: 'Use Data Tables',
-                name: 'useDataTables',
-                type: 'boolean',
-                default: true,
-                description: 'Use n8n Data Tables when available, with filesystem fallback',
+                description: 'Root folder used for session auth files and metadata',
             },
         ];
     }

package/dist/nodes/WhatsThatMessage/WhatsThatMessage.node.js

@@ -4,12 +4,13 @@ exports.WhatsThatMessage = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
 const access_1 = require("../../shared/access");
 const runtime_1 = require("../../shared/runtime");
+const validation_1 = require("../../shared/validation");
 function buildPayload(context, itemIndex) {
     const messageType = context.getNodeParameter('messageType', itemIndex);
     const targetMode = context.getNodeParameter('targetMode', itemIndex);
     const deliveryMode = context.getNodeParameter('deliveryMode', itemIndex, 'native');
     const payload = {
-        sessionId: context.getNodeParameter('sessionId', itemIndex),
+        sessionId: (0, validation_1.requireSessionId)(context.getNodeParameter('sessionId', itemIndex)),
         type: messageType,
     };
     if (targetMode === 'alias') {
@@ -72,7 +73,14 @@ class WhatsThatMessage {
             outputs: ['main'],
             credentials: [{ name: 'whatsThatRuntime', required: true }],
             properties: [
-                { displayName: 'Session ID', name: 'sessionId', type: 'string', default: '' },
+                {
+                    displayName: 'Session ID (Internal)',
+                    name: 'sessionId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'The unique session ID created in the WhatsThat Session node.',
+                },
                 {
                     displayName: 'Target Mode',
                     name: 'targetMode',

package/dist/nodes/WhatsThatSession/WhatsThatSession.node.js

@@ -4,6 +4,7 @@ exports.WhatsThatSession = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
 const access_1 = require("../../shared/access");
 const runtime_1 = require("../../shared/runtime");
+const validation_1 = require("../../shared/validation");
 class WhatsThatSession {
     constructor() {
         this.description = {
@@ -33,19 +34,22 @@ class WhatsThatSession {
                     ],
                 },
                 {
-                    displayName: 'Session ID',
+                    displayName: 'Session ID (Internal)',
                     name: 'sessionId',
                     type: 'string',
                     default: '',
+                    required: true,
+                    description: 'Required unique ID for this session. Use a stable internal value such as "main-phone" or "support-team".',
                     displayOptions: {
                         hide: { operation: ['list'] },
                     },
                 },
                 {
-                    displayName: 'Label',
+                    displayName: 'Label (Visible Name)',
                     name: 'label',
                     type: 'string',
                     default: '',
+                    description: 'Human-readable name shown in results. Example: "Luca personal phone" or "Support number".',
                     displayOptions: {
                         show: { operation: ['create'] },
                     },
@@ -55,7 +59,7 @@ class WhatsThatSession {
                     name: 'phoneNumberForPairing',
                     type: 'string',
                     default: '',
-                    description: 'Optional. When provided, WhatsThat will request a pairing code when possible',
+                    description: 'Optional. Full phone number with country code, digits only, without 00 or +. Example: 393331234567.',
                     displayOptions: {
                         show: { operation: ['create'] },
                     },
@@ -70,14 +74,17 @@ class WhatsThatSession {
         for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
             try {
                 const operation = this.getNodeParameter('operation', itemIndex);
-                const sessionId = this.getNodeParameter('sessionId', itemIndex, '');
+                const rawSessionId = this.getNodeParameter('sessionId', itemIndex, '');
+                const sessionId = operation === 'list' ? (0, validation_1.normalizeSessionId)(rawSessionId) : (0, validation_1.requireSessionId)(rawSessionId);
                 let json;
+                const label = this.getNodeParameter('label', itemIndex, '').trim();
+                const phoneNumberForPairing = this.getNodeParameter('phoneNumberForPairing', itemIndex, '').trim();
                 switch (operation) {
                     case 'create':
                         json = await runtime_1.registry.ensureSession(access.paths.root, access, {
                             sessionId,
-                            label: this.getNodeParameter('label', itemIndex) || sessionId,
-                            phoneNumberForPairing: this.getNodeParameter('phoneNumberForPairing', itemIndex, ''),
+                            label: label || sessionId,
+                            phoneNumberForPairing,
                         });
                         break;
                     case 'connect':

package/dist/nodes/WhatsThatTargets/WhatsThatTargets.node.js

@@ -4,6 +4,7 @@ exports.WhatsThatTargets = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
 const access_1 = require("../../shared/access");
 const runtime_1 = require("../../shared/runtime");
+const validation_1 = require("../../shared/validation");
 class WhatsThatTargets {
     constructor() {
         this.description = {
@@ -31,10 +32,12 @@ class WhatsThatTargets {
                     ],
                 },
                 {
-                    displayName: 'Session ID',
+                    displayName: 'Session ID (Internal)',
                     name: 'sessionId',
                     type: 'string',
                     default: '',
+                    required: true,
+                    description: 'The unique session ID created in the WhatsThat Session node.',
                 },
                 {
                     displayName: 'Target JID',
@@ -64,7 +67,7 @@ class WhatsThatTargets {
         for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
             try {
                 const operation = this.getNodeParameter('operation', itemIndex);
-                const sessionId = this.getNodeParameter('sessionId', itemIndex);
+                const sessionId = (0, validation_1.requireSessionId)(this.getNodeParameter('sessionId', itemIndex));
                 let json;
                 switch (operation) {
                     case 'listDiscovered':

package/dist/nodes/WhatsThatTrigger/WhatsThatTrigger.node.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WhatsThatTrigger = void 0;
 const runtime_1 = require("../../shared/runtime");
+const validation_1 = require("../../shared/validation");
 class WhatsThatTrigger {
     constructor() {
         this.description = {
@@ -16,7 +17,14 @@ class WhatsThatTrigger {
             outputs: ['main'],
             credentials: [{ name: 'whatsThatRuntime', required: true }],
             properties: [
-                { displayName: 'Session ID', name: 'sessionId', type: 'string', default: '' },
+                {
+                    displayName: 'Session ID (Internal)',
+                    name: 'sessionId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'The unique session ID created in the WhatsThat Session node.',
+                },
                 {
                     displayName: 'Event',
                     name: 'eventName',
@@ -38,7 +46,7 @@ class WhatsThatTrigger {
         };
     }
     async trigger() {
-        const sessionId = this.getNodeParameter('sessionId');
+        const sessionId = (0, validation_1.requireSessionId)(this.getNodeParameter('sessionId'));
         const eventName = this.getNodeParameter('eventName');
         const handler = (event) => {
             if (event.sessionId !== sessionId)

package/dist/shared/context.d.ts

@@ -1,8 +1,7 @@
-import type { IDataObject, IExecuteFunctions, ILoadOptionsFunctions, IDataTableProjectAggregateService, IDataTableProjectService } from 'n8n-workflow';
+import type { IDataObject, IExecuteFunctions, ILoadOptionsFunctions } from 'n8n-workflow';
 export type NodeContext = IExecuteFunctions | ILoadOptionsFunctions;
 export interface RuntimeConfig {
     storagePath: string;
-    useDataTables: boolean;
 }
 export declare function getRuntimeConfig(context: NodeContext): Promise<RuntimeConfig>;
 export declare function runtimePaths(config: RuntimeConfig): {
@@ -10,6 +9,4 @@ export declare function runtimePaths(config: RuntimeConfig): {
     authRoot: string;
     tablesFallback: string;
 };
-export declare function getAggregateProxy(context: NodeContext): Promise<IDataTableProjectAggregateService | null>;
-export declare function getTableProxy(context: NodeContext, tableId: string): Promise<IDataTableProjectService | null>;
 export declare function asDataObject(value: unknown): IDataObject;

package/dist/shared/context.js

@@ -5,8 +5,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRuntimeConfig = getRuntimeConfig;
 exports.runtimePaths = runtimePaths;
-exports.getAggregateProxy = getAggregateProxy;
-exports.getTableProxy = getTableProxy;
 exports.asDataObject = asDataObject;
 const node_path_1 = __importDefault(require("node:path"));
 async function getRuntimeConfig(context) {
@@ -14,7 +12,6 @@ async function getRuntimeConfig(context) {
     const storagePath = String(credentials.storagePath || '/home/node/.n8n/whatsthat');
     return {
         storagePath,
-        useDataTables: Boolean(credentials.useDataTables ?? true),
     };
 }
 function runtimePaths(config) {
@@ -24,18 +21,6 @@ function runtimePaths(config) {
         tablesFallback: node_path_1.default.join(config.storagePath, 'tables'),
     };
 }
-async function getAggregateProxy(context) {
-    if (!context.helpers.getDataTableAggregateProxy) {
-        return null;
-    }
-    return context.helpers.getDataTableAggregateProxy();
-}
-async function getTableProxy(context, tableId) {
-    if (!context.helpers.getDataTableProxy) {
-        return null;
-    }
-    return context.helpers.getDataTableProxy(tableId);
-}
 function asDataObject(value) {
     return value;
 }

package/dist/shared/store.d.ts

@@ -7,6 +7,6 @@ type StorePayloadMap = {
     discovered_targets: DiscoveredTarget[];
     dedup: DedupRecord[];
 };
-export declare function listRecords<T extends TableName>(context: NodeContext, config: RuntimeConfig, tableName: T): Promise<StorePayloadMap[T]>;
-export declare function saveRecords<T extends TableName>(context: NodeContext, config: RuntimeConfig, tableName: T, data: StorePayloadMap[T]): Promise<void>;
+export declare function listRecords<T extends TableName>(_context: NodeContext, config: RuntimeConfig, tableName: T): Promise<StorePayloadMap[T]>;
+export declare function saveRecords<T extends TableName>(_context: NodeContext, config: RuntimeConfig, tableName: T, data: StorePayloadMap[T]): Promise<void>;
 export {};

package/dist/shared/store.js

@@ -8,94 +8,14 @@ exports.saveRecords = saveRecords;
 const node_path_1 = __importDefault(require("node:path"));
 const context_1 = require("./context");
 const fs_1 = require("./fs");
-const tableSchemas = {
-    sessions: [
-        { name: 'sessionId', type: 'string' },
-        { name: 'label', type: 'string' },
-        { name: 'status', type: 'string' },
-        { name: 'phone', type: 'string' },
-        { name: 'pairingCode', type: 'string' },
-        { name: 'qr', type: 'string' },
-        { name: 'qrDataUrl', type: 'string' },
-        { name: 'phoneNumberForPairing', type: 'string' },
-        { name: 'lastSeenAt', type: 'string' },
-        { name: 'createdAt', type: 'string' },
-        { name: 'updatedAt', type: 'string' },
-        { name: 'lastDisconnectReason', type: 'string' },
-    ],
-    linked_targets: [
-        { name: 'alias', type: 'string' },
-        { name: 'sessionId', type: 'string' },
-        { name: 'jid', type: 'string' },
-        { name: 'displayName', type: 'string' },
-        { name: 'targetType', type: 'string' },
-        { name: 'lastSeenAt', type: 'string' },
-        { name: 'createdAt', type: 'string' },
-    ],
-    discovered_targets: [
-        { name: 'sessionId', type: 'string' },
-        { name: 'jid', type: 'string' },
-        { name: 'displayName', type: 'string' },
-        { name: 'targetType', type: 'string' },
-        { name: 'lastSeenAt', type: 'string' },
-    ],
-    dedup: [
-        { name: 'sessionId', type: 'string' },
-        { name: 'messageId', type: 'string' },
-        { name: 'expiresAt', type: 'string' },
-    ],
-};
-async function ensureTable(context, tableName) {
-    const aggregate = await (0, context_1.getAggregateProxy)(context);
-    if (!aggregate) {
-        return null;
-    }
-    const existing = await aggregate.getManyAndCount({ filter: { name: tableName } });
-    const found = existing.data.find((table) => table.name === tableName);
-    if (found) {
-        return found.id;
-    }
-    const created = await aggregate.createDataTable({
-        name: tableName,
-        columns: tableSchemas[tableName],
-    });
-    return created.id;
-}
 async function fallbackFile(config, tableName) {
     const filePath = node_path_1.default.join((0, context_1.runtimePaths)(config).tablesFallback, `${tableName}.json`);
     await (0, fs_1.ensureDir)(node_path_1.default.dirname(filePath));
     return filePath;
 }
-async function listRecords(context, config, tableName) {
-    if (config.useDataTables) {
-        const tableId = await ensureTable(context, tableName);
-        if (tableId) {
-            const table = await (0, context_1.getTableProxy)(context, tableId);
-            if (table) {
-                const rows = await table.getManyRowsAndCount({});
-                return rows.data;
-            }
-        }
-    }
+async function listRecords(_context, config, tableName) {
     return (0, fs_1.readJson)(await fallbackFile(config, tableName), []);
 }
-async function saveRecords(context, config, tableName, data) {
-    if (config.useDataTables) {
-        const tableId = await ensureTable(context, tableName);
-        if (tableId) {
-            const table = await (0, context_1.getTableProxy)(context, tableId);
-            if (table) {
-                await table.deleteDataTable();
-                const recreatedTableId = await ensureTable(context, tableName);
-                const recreated = recreatedTableId
-                    ? await (0, context_1.getTableProxy)(context, recreatedTableId)
-                    : null;
-                if (recreated && data.length > 0) {
-                    await recreated.insertRows(data, 'count');
-                }
-                return;
-            }
-        }
-    }
+async function saveRecords(_context, config, tableName, data) {
     await (0, fs_1.writeJson)(await fallbackFile(config, tableName), data);
 }

package/dist/shared/validation.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeSessionId(sessionId: string): string;
+export declare function requireSessionId(sessionId: string): string;

package/dist/shared/validation.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeSessionId = normalizeSessionId;
+exports.requireSessionId = requireSessionId;
+function normalizeSessionId(sessionId) {
+    return sessionId.trim();
+}
+function requireSessionId(sessionId) {
+    const normalized = normalizeSessionId(sessionId);
+    if (!normalized) {
+        throw new Error('Session ID is required. Use a stable internal identifier such as "main-phone" or "support-team".');
+    }
+    return normalized;
+}

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@jep182/n8n-nodes-whatsthat",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "n8n community nodes with embedded Baileys runtime for multi-session chat automation",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "homepage": "https://github.com/jep182/whatsapp-bot",
+  "homepage": "https://github.com/jepgambardella/n8n-nodes-whatsthat",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/jep182/whatsapp-bot.git"
+    "url": "git+https://github.com/jepgambardella/n8n-nodes-whatsthat.git"
   },
   "bugs": {
-    "url": "https://github.com/jep182/whatsapp-bot/issues"
+    "url": "https://github.com/jepgambardella/n8n-nodes-whatsthat/issues"
   },
   "author": "jep182",
   "keywords": [