@jep182/n8n-nodes-whatsthat 0.4.2 → 0.4.3

package/README.md

@@ -17,8 +17,8 @@ It lets you:
 
 Use this node to:
 
-- create a session
 - connect a session
+- wait for a session to become connected
 - list sessions
 - inspect session status
 - disconnect a session
@@ -86,14 +86,15 @@ WhatsThat embeds Baileys directly in n8n.
 ```
 
 3. Add `WhatsThat Session`.
-4. Choose `Ensure Session`, then provide:
+4. Choose `Connect Session`, then provide:
    - `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. Set `Return When` to `Pairing Is Ready Or Connected` for first-time pairing.
-6. Use the returned `pairingCode`, `qrCodeUrl`, or `qrDataUrl` to connect the device.
-7. Use `WhatsThat Targets` to discover and link chats/groups.
-8. Use `WhatsThat Message` to send messages by alias or raw JID.
+5. Run the node and use the returned `pairingCode`, `qrCodeUrl`, or `qrDataUrl` to connect the device.
+6. Add another `WhatsThat Session` node with `Ensure Session`.
+7. Set `Return When` to `Connected` so the workflow waits until the already-started session finishes pairing.
+8. Use `WhatsThat Targets` to discover and link chats/groups.
+9. Use `WhatsThat Message` to send messages by alias or raw JID.
 
 Example workflow:
 

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

@@ -23,8 +23,9 @@ class WhatsThatSession {
                     displayName: 'Operation',
                     name: 'operation',
                     type: 'options',
-                    default: 'ensure',
+                    default: 'connect',
                     options: [
+                        { name: 'Connect Session', value: 'connect' },
                         { name: 'Ensure Session', value: 'ensure' },
                         { name: 'List Sessions', value: 'list' },
                         { name: 'Get Session Status', value: 'status' },
@@ -50,7 +51,7 @@ class WhatsThatSession {
                     default: '',
                     description: 'Human-readable name shown in results. Example: "Luca personal phone" or "Support number".',
                     displayOptions: {
-                        show: { operation: ['ensure'] },
+                        show: { operation: ['connect', 'ensure'] },
                     },
                 },
                 {
@@ -60,7 +61,7 @@ class WhatsThatSession {
                     default: '',
                     description: 'Optional. Full phone number with country code, digits only, without 00 or +. Example: 393331234567.',
                     displayOptions: {
-                        show: { operation: ['ensure'] },
+                        show: { operation: ['connect', 'ensure'] },
                     },
                 },
                 {
@@ -104,6 +105,17 @@ class WhatsThatSession {
                 const sessionId = operation === 'list' ? (0, validation_1.normalizeSessionId)(rawSessionId) : (0, validation_1.requireSessionId)(rawSessionId);
                 let json;
                 switch (operation) {
+                    case 'connect': {
+                        const label = this.getNodeParameter('label', itemIndex, '').trim();
+                        const phoneNumberForPairing = this.getNodeParameter('phoneNumberForPairing', itemIndex, '').trim();
+                        await runtime_1.registry.ensureSession(access.paths.root, access, {
+                            sessionId,
+                            label: label || sessionId,
+                            phoneNumberForPairing,
+                        });
+                        json = await runtime_1.registry.connectSession(access.paths.root, access, sessionId);
+                        break;
+                    }
                     case 'ensure': {
                         const label = this.getNodeParameter('label', itemIndex, '').trim();
                         const phoneNumberForPairing = this.getNodeParameter('phoneNumberForPairing', itemIndex, '').trim();

package/dist/shared/runtime.d.ts

@@ -46,7 +46,7 @@ declare class WhatsThatRegistry extends EventEmitter {
         phoneNumberForPairing?: string;
     }): Promise<SessionRecord>;
     connectSession(storageRoot: string, access: DataAccess, sessionId: string): Promise<SessionRecord>;
-    ensureConnectedSession(storageRoot: string, access: DataAccess, input: {
+    ensureConnectedSession(_storageRoot: string, access: DataAccess, input: {
         sessionId: string;
         label: string;
         phoneNumberForPairing?: string;
@@ -71,6 +71,7 @@ declare class WhatsThatRegistry extends EventEmitter {
     private emitRuntime;
     private waitForSessionState;
     private matchesWaitTarget;
+    waitForConnectedSession(access: DataAccess, sessionId: string, timeoutMs: number): Promise<SessionRecord>;
     private required;
     private buildQrCodeUrl;
 }

package/dist/shared/runtime.js

@@ -219,14 +219,14 @@ class WhatsThatRegistry extends node_events_1.EventEmitter {
         this.sockets.set(sessionId, socket);
         return (await this.getSession(access, sessionId)) ?? starting;
     }
-    async ensureConnectedSession(storageRoot, access, input, options) {
-        await this.ensureSession(storageRoot, access, input);
+    async ensureConnectedSession(_storageRoot, access, input, options) {
+        await this.ensureSession(_storageRoot, access, input);
         const current = await this.getSession(access, input.sessionId);
         if (!current) {
             throw new Error(`Unknown session ${input.sessionId}`);
         }
         if (!this.sockets.has(input.sessionId) && current.status !== 'connected') {
-            await this.connectSession(storageRoot, access, input.sessionId);
+            throw new Error(`Session ${input.sessionId} is not active. Run Connect Session first and keep the n8n runtime alive until pairing completes.`);
         }
         return this.waitForSessionState(access, input.sessionId, options?.waitFor ?? 'pairing_or_connected', options?.timeoutMs ?? 20000);
     }
@@ -508,6 +508,16 @@ class WhatsThatRegistry extends node_events_1.EventEmitter {
         }
         return false;
     }
+    async waitForConnectedSession(access, sessionId, timeoutMs) {
+        const current = await this.getSession(access, sessionId);
+        if (!current) {
+            throw new Error(`Unknown session ${sessionId}`);
+        }
+        if (!this.sockets.has(sessionId) && current.status !== 'connected') {
+            throw new Error(`Session ${sessionId} is not active. Run Connect Session first and keep the n8n runtime alive until pairing completes.`);
+        }
+        return this.waitForSessionState(access, sessionId, 'connected', timeoutMs);
+    }
     required(value, field) {
         if (value === undefined || value === null || value === '') {
             throw new Error(`Missing required field ${field}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jep182/n8n-nodes-whatsthat",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "n8n community nodes with embedded Baileys runtime for multi-session chat automation",
   "license": "MIT",
   "main": "dist/index.js",