n8n-nodes-apivault-whatsapp-validator 0.2.0 → 0.3.0

package/README.md

@@ -1,44 +1,11 @@
-# n8n-nodes-apivault-whatsapp-validator
+# WhatsApp Number Validator — n8n node
 
-An [n8n](https://n8n.io) community node for **WhatsApp Number Validator**, powered by the [`apivault_labs/whatsapp-number-validator` Apify Actor](https://apify.com/apivault_labs/whatsapp-number-validator).
+Calls the hosted [Apify Actor](https://apify.com/apivault_labs/whatsapp-number-validator). Requires your own Apify credential; Apify run charges apply.
 
-Run WhatsApp Number Validator through the hosted Apify Actor and return structured Dataset results.
+Install `n8n-nodes-apivault-whatsapp-validator` through Settings → Community nodes → Install in self-hosted n8n.
 
-The node is a thin connector: collection, analysis, retries and billing run in the hosted Actor. It contains no private scraper implementation or embedded credentials.
+## Upgrade compatibility
 
-## Installation
+Existing node names, credential type and input parameter names are retained. Existing version 1 workflows keep their previous charge behavior unless an event cap is selected. New version 2 nodes default to a $0.05 event charge cap and 1,000 downloaded rows; platform usage can be charged separately. Select Read Existing Run and provide the Run ID to resume without starting a paid duplicate. Full output includes run metadata, SUMMARY and ERRORS when available. Dataset rows retain their original fields and paired input item. Actor build is latest.
 
-1. Open **Settings → Community Nodes** in your n8n instance.
-2. Select **Install**.
-3. Enter `n8n-nodes-apivault-whatsapp-validator` and confirm.
-
-## Credentials
-
-Create an **Apify API** credential in n8n and paste your personal token from [Apify Console → Integrations](https://console.apify.com/account/integrations). The token is sent to Apify as a bearer credential and is never bundled with this package.
-
-## Usage
-
-Add **WhatsApp Number Validator** to a workflow, fill the public Actor inputs below, and execute the node. Every Dataset result becomes one n8n item, so it can flow into Sheets, databases, CRMs, alerts or your own code. The node respects n8n's **Continue On Fail** behavior.
-
-| Input | Type | Description |
-|---|---|---|
-| `workflow` | `string` | Choose how numbers are supplied. Auto merges both input fields and preserves existing API behavior. |
-| `phoneNumbers` | `array` | Phone numbers to validate (one per line). Include the country code with a leading + when possible, e.g. +14155552671. Numbers without a + are parsed using the Default country below |
-| `numbersText` | `string` | Optional. Paste many numbers at once (one per line, or comma/semicolon separated — e.g. a copied spreadsheet column). They are merged with the list above and de-duplicated. |
-| `defaultCountry` | `string` | ISO 3166 alpha-2 region code (US, GB, BR, IN, DE, ...) used to interpret numbers that don't start with +. Leave empty to require + on every number. |
-| `outputPreset` | `string` | Full is best for AI and APIs. CSV is flat for spreadsheets. Both keeps full JSON and adds a nested CSV-friendly record. |
-| `exportFormat` | `string` | Backwards-compatible API option. Leave at default to use Output preset above. |
-
-## Pricing
-
-The package is free. Actor runs are billed by Apify using the pricing shown on the [Actor page](https://apify.com/apivault_labs/whatsapp-number-validator); platform usage may also apply.
-
-## Resources
-
-- [Actor and live input schema](https://apify.com/apivault_labs/whatsapp-number-validator)
-- [Source repository](https://github.com/apivault-labs/n8n-nodes-apivault-whatsapp-validator)
-- [n8n community-node documentation](https://docs.n8n.io/integrations/community-nodes/)
-
-## License
-
-MIT. The hosted Actor is a separate paid service governed by Apify terms.
+Runtime dependencies: none. n8n Cloud availability requires separate n8n verification.

package/dist/credentials/ApifyApi.credentials.d.ts

@@ -1,6 +1,10 @@
 import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
 export declare class ApifyApi implements ICredentialType {
     name: string;
+    icon: {
+        readonly light: "file:apivault.svg";
+        readonly dark: "file:apivault.svg";
+    };
     displayName: string;
     documentationUrl: string;
     properties: INodeProperties[];

package/dist/credentials/ApifyApi.credentials.js

@@ -2,27 +2,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApifyApi = void 0;
 class ApifyApi {
-    constructor() {
-        this.name = 'apifyApi';
-        this.displayName = 'Apify API';
-        this.documentationUrl = 'https://docs.apify.com/platform/integrations/api';
-        this.properties = [
-            {
-                displayName: 'API Token',
-                name: 'apiToken',
-                type: 'string',
-                typeOptions: { password: true },
-                default: '',
-                required: true,
-                description: 'Your personal Apify API token (Apify Console -> Settings -> Integrations).',
-            },
-        ];
-        this.authenticate = {
-            type: 'generic',
-            properties: { headers: { Authorization: '=Bearer {{$credentials.apiToken}}' } },
-        };
-        this.test = { request: { baseURL: 'https://api.apify.com/v2', url: '/users/me' } };
-    }
+    name = 'apifyApi';
+    icon = { light: 'file:apivault.svg', dark: 'file:apivault.svg' };
+    displayName = 'Apify API';
+    documentationUrl = 'https://docs.apify.com/platform/integrations/api';
+    properties = [
+        {
+            displayName: 'API Token',
+            name: 'apiToken',
+            type: 'string',
+            typeOptions: { password: true },
+            default: '',
+            required: true,
+            description: 'Your personal Apify API token (Apify Console -> Settings -> Integrations).',
+        },
+    ];
+    authenticate = {
+        type: 'generic',
+        properties: { headers: { Authorization: '=Bearer {{$credentials.apiToken}}' } },
+    };
+    test = { request: { baseURL: 'https://api.apify.com/v2', url: '/users/me' } };
 }
 exports.ApifyApi = ApifyApi;
-//# sourceMappingURL=ApifyApi.credentials.js.map

package/dist/credentials/apivault.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="14" fill="#4f46e5"/><path d="M16 48 28 16h8l12 32H38l-2-7H26l-2 7zm12-15h6l-3-10z" fill="white"/></svg>

package/dist/nodes/WhatsappValidator/WhatsappValidator.node.js

@@ -2,26 +2,47 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WhatsappValidator = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
-const ACTOR_ID = 'apivault_labs~whatsapp-number-validator';
+const actorTransport_1 = require("../helpers/actorTransport");
+const ACTOR_ID = 'LP2X15E8c4ebfnPRC';
 class WhatsappValidator {
-    constructor() {
-        this.description = {
-            displayName: 'WhatsApp Number Validator',
-            name: 'whatsappValidator',
-            icon: 'file:whatsappvalidator.svg',
-            group: ['transform'],
-            version: 1,
-            description: 'Run WhatsApp Number Validator through the hosted Apify Actor and return structured Dataset results.',
-            defaults: { name: 'WhatsApp Number Validator' },
-            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
-            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
-            usableAsTool: true,
-            credentials: [{ name: 'apifyApi', required: true }],
-            properties: [
+    description = {
+        "displayName": "WhatsApp Number Validator",
+        "name": "whatsappValidator",
+        "icon": {
+            "light": "file:whatsappvalidator.svg",
+            "dark": "file:whatsappvalidator.svg"
+        },
+        "subtitle": "={{$parameter[\"apivaultMode\"]}}",
+        "group": [
+            "transform"
+        ],
+        "version": [
+            1,
+            2
+        ],
+        "description": "Run WhatsApp Number Validator through the hosted Apify Actor and read its results",
+        "defaults": {
+            "name": "WhatsApp Number Validator"
+        },
+        "inputs": [
+            n8n_workflow_1.NodeConnectionTypes.Main
+        ],
+        "outputs": [
+            n8n_workflow_1.NodeConnectionTypes.Main
+        ],
+        "usableAsTool": true,
+        "credentials": [
+            {
+                "name": "apifyApi",
+                "required": true
+            }
+        ],
+        "defaultVersion": 2,
+        properties: [...actorTransport_1.executionProperties, ...[
                 {
                     "displayName": "Workflow",
                     "name": "workflow",
-                    "description": "Choose how numbers are supplied. Auto merges both input fields and preserves existing API behavior.",
+                    "description": "Actor input: Workflow",
                     "type": "options",
                     "options": [
                         {
@@ -37,33 +58,61 @@ class WhatsappValidator {
                             "value": "text"
                         }
                     ],
-                    "default": "auto"
+                    "default": "auto",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Phone numbers",
                     "name": "phoneNumbers",
-                    "description": "Phone numbers to validate (one per line). Include the country code with a leading + when possible, e.g. +14155552671. Numbers without a + are parsed using the Default country below. (comma or new-line separated)",
+                    "description": "Actor input: Phone numbers",
                     "type": "string",
-                    "default": ""
+                    "default": "",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "…or paste a list / CSV column",
                     "name": "numbersText",
-                    "description": "Optional. Paste many numbers at once (one per line, or comma/semicolon separated — e.g. a copied spreadsheet column). They are merged with the list above and de-duplicated.",
+                    "description": "Actor input: …or paste a list / CSV column",
                     "type": "string",
-                    "default": ""
+                    "default": "",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Default country (for numbers without +)",
                     "name": "defaultCountry",
-                    "description": "ISO 3166 alpha-2 region code (US, GB, BR, IN, DE, ...) used to interpret numbers that don't start with +. Leave empty to require + on every number.",
+                    "description": "Actor input: Default country (for numbers without +)",
                     "type": "string",
-                    "default": "US"
+                    "default": "US",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Output preset",
                     "name": "outputPreset",
-                    "description": "Full is best for AI and APIs. CSV is flat for spreadsheets. Both keeps full JSON and adds a nested CSV-friendly record.",
+                    "description": "Actor input: Output preset",
                     "type": "options",
                     "options": [
                         {
@@ -79,12 +128,19 @@ class WhatsappValidator {
                             "value": "both"
                         }
                     ],
-                    "default": "full"
+                    "default": "full",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Legacy export format override",
                     "name": "exportFormat",
-                    "description": "Backwards-compatible API option. Leave at default to use Output preset above.",
+                    "description": "Actor input: Legacy export format override",
                     "type": "options",
                     "options": [
                         {
@@ -100,71 +156,49 @@ class WhatsappValidator {
                             "value": "both"
                         }
                     ],
-                    "default": "default"
+                    "default": "default",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 }
-            ],
-        };
-    }
+            ]]
+    };
     async execute() {
-        var _b;
-        const items = this.getInputData();
-        const returnData = [];
-        for (let i = 0; i < items.length; i++) {
+        const output = [];
+        for (let i = 0; i < this.getInputData().length; i++) {
             try {
-                const body = {};
-                body["workflow"] = this.getNodeParameter("workflow", i);
-                {
-                    const _v = this.getNodeParameter("phoneNumbers", i, '');
-                    const _a = _v.split(/[,\n]/).map(s => s.trim()).filter(s => s.length > 0);
-                    if (_a.length)
-                        body["phoneNumbers"] = _a;
-                }
-                body["numbersText"] = this.getNodeParameter("numbersText", i);
-                body["defaultCountry"] = this.getNodeParameter("defaultCountry", i);
-                body["outputPreset"] = this.getNodeParameter("outputPreset", i);
-                body["exportFormat"] = this.getNodeParameter("exportFormat", i);
-                const options = {
-                    method: 'POST',
-                    url: `https://api.apify.com/v2/acts/${ACTOR_ID}/runs`,
-                    body,
-                    json: true,
-                };
-                const started = await this.helpers.requestWithAuthentication.call(this, 'apifyApi', options);
-                const runId = (_b = started === null || started === void 0 ? void 0 : started.data) === null || _b === void 0 ? void 0 : _b.id;
-                if (!runId)
-                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Apify did not return a run ID', { itemIndex: i });
-                let run = started.data;
-                const deadline = Date.now() + 60 * 60 * 1000;
-                while (!['SUCCEEDED', 'FAILED', 'ABORTED', 'TIMED-OUT'].includes(run.status)) {
-                    if (Date.now() >= deadline)
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Waiting timed out; check the existing run in Apify before retrying', { itemIndex: i });
-                    const polled = await this.helpers.requestWithAuthentication.call(this, 'apifyApi', { method: 'GET', url: `https://api.apify.com/v2/actor-runs/${runId}?waitForFinish=20`, json: true });
-                    run = polled.data;
-                }
-                if (run.status !== 'SUCCEEDED')
-                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Apify run ended with status ' + run.status, { itemIndex: i });
-                let offset = 0;
-                while (true) {
-                    const page = await this.helpers.requestWithAuthentication.call(this, 'apifyApi', { method: 'GET', url: `https://api.apify.com/v2/datasets/${run.defaultDatasetId}/items?clean=1&limit=1000&offset=${offset}`, json: true });
-                    if (!Array.isArray(page))
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Unexpected Dataset response', { itemIndex: i });
-                    for (const result of page)
-                        returnData.push({ json: result, pairedItem: { item: i } });
-                    offset += page.length;
-                    if (page.length < 1000)
-                        break;
-                }
+                const body = this.getNodeParameter('apivaultMode', i, 'run') === 'read' ? {} : (() => {
+                    const body = {};
+                    body["workflow"] = this.getNodeParameter("workflow", i);
+                    {
+                        const _v = this.getNodeParameter("phoneNumbers", i, '');
+                        const _a = _v.split(/[,\n]/).map(s => s.trim()).filter(s => s.length > 0);
+                        if (_a.length)
+                            body["phoneNumbers"] = _a;
+                    }
+                    body["numbersText"] = this.getNodeParameter("numbersText", i);
+                    body["defaultCountry"] = this.getNodeParameter("defaultCountry", i);
+                    body["outputPreset"] = this.getNodeParameter("outputPreset", i);
+                    body["exportFormat"] = this.getNodeParameter("exportFormat", i);
+                    return body;
+                })();
+                const results = await (0, actorTransport_1.runActor)(this, i, ACTOR_ID, body);
+                for (const result of results)
+                    output.push({ json: result, pairedItem: { item: i } });
             }
             catch (error) {
-                if (this.continueOnFail()) {
-                    returnData.push({ json: { error: error.message }, pairedItem: { item: i } });
-                    continue;
-                }
-                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: i });
+                const message = error instanceof actorTransport_1.SafeActorError ? error.message : 'Could not finish the Actor request. Check inputs and credentials; use Read Existing Run if a run was already started';
+                if (this.continueOnFail())
+                    output.push({ json: { error: message }, pairedItem: { item: i } });
+                else
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), message, { itemIndex: i });
             }
         }
-        return [returnData];
+        return [output];
     }
 }
 exports.WhatsappValidator = WhatsappValidator;
-//# sourceMappingURL=WhatsappValidator.node.js.map

package/dist/nodes/helpers/actorTransport.d.ts

@@ -0,0 +1,9 @@
+import type { IExecuteFunctions, INodeProperties, IDataObject } from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+export declare class SafeActorError extends NodeOperationError {
+    readonly runId: string;
+    constructor(context: IExecuteFunctions, runId: string, item: number);
+}
+export declare const executionProperties: INodeProperties[];
+export declare function runActor(context: IExecuteFunctions, item: number, actorId: string, body: Record<string, unknown>): Promise<IDataObject[]>;
+export declare function legacyRequest(context: IExecuteFunctions, item: number, raw: unknown): Promise<any>;

package/dist/nodes/helpers/actorTransport.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executionProperties = exports.SafeActorError = void 0;
+exports.runActor = runActor;
+exports.legacyRequest = legacyRequest;
+const n8n_workflow_1 = require("n8n-workflow");
+const API = 'https://api.apify.com/v2';
+const id = (value) => {
+    if (typeof value !== 'string' || !/^[A-Za-z0-9_-]{1,100}$/.test(value))
+        throw new Error('Invalid Apify identifier');
+    return value;
+};
+class SafeActorError extends n8n_workflow_1.NodeOperationError {
+    runId;
+    constructor(context, runId, item) {
+        super(context.getNode(), runId ? `Could not finish reading run ${runId}; select Read Existing Run to resume` : 'Could not start or read the Actor. Check inputs and credentials before retrying', { itemIndex: item });
+        this.runId = runId;
+    }
+}
+exports.SafeActorError = SafeActorError;
+exports.executionProperties = [
+    { displayName: 'Run Mode', name: 'apivaultMode', type: 'options', noDataExpression: true,
+        options: [{ name: 'Run Actor', value: 'run', action: 'Run the actor' }, { name: 'Read Existing Run', value: 'read', action: 'Read an existing run' }], default: 'run' },
+    { displayName: 'Execution Options', name: 'apivaultExecution', type: 'collection', placeholder: 'Add Option', default: {}, options: [
+            { displayName: 'Run ID', name: 'runId', type: 'string', default: '', description: 'Existing Apify run to resume without starting a paid duplicate' },
+            { displayName: 'Maximum Event Charge (USD)', name: 'maxTotalChargeUsd', type: 'number', default: 0.05,
+                typeOptions: { minValue: 0.001, maxValue: 1000, numberPrecision: 3 }, description: 'Event charge cap. Platform usage may be billed separately.' },
+            { displayName: 'Maximum Rows to Read', name: 'maxRows', type: 'number', default: 1000,
+                typeOptions: { minValue: 1, maxValue: 100000, numberPrecision: 0 }, description: 'Download cap only. Actor input limits control paid collection.' },
+            { displayName: 'Output', name: 'output', type: 'options', default: 'rows',
+                options: [{ name: 'Dataset Rows', value: 'rows' }, { name: 'Run, Rows and Diagnostics', value: 'full' }], description: 'Include SUMMARY and ERRORS to inspect partial or empty results' },
+        ] },
+];
+async function runActor(context, item, actorId, body) {
+    let runId = '';
+    try {
+        const mode = context.getNodeParameter('apivaultMode', item, 'run');
+        const options = context.getNodeParameter('apivaultExecution', item, {});
+        const legacy = context.getNode().typeVersion < 2;
+        const maxRows = options.maxRows ?? (legacy ? 100000 : 1000);
+        if (!Number.isInteger(maxRows) || maxRows < 1 || maxRows > 100000)
+            throw new Error('Invalid row limit');
+        const request = async (requestOptions) => context.helpers.httpRequestWithAuthentication.call(context, 'apifyApi', requestOptions);
+        if (mode === 'run') {
+            const cap = options.maxTotalChargeUsd ?? (legacy ? undefined : 0.05);
+            if (cap !== undefined && (!Number.isFinite(cap) || cap <= 0 || cap > 1000))
+                throw new Error('Invalid event charge cap');
+            // Legacy workflows retain their existing charge behavior unless a cap is selected.
+            const qs = { build: 'latest' };
+            if (cap !== undefined)
+                qs.maxTotalChargeUsd = cap;
+            // Never retry POST: a duplicate could create a second paid Actor run.
+            const started = await request({ method: 'POST', url: `${API}/acts/${id(actorId)}/runs`, body: body, qs, json: true });
+            runId = id(started?.data?.id);
+        }
+        else if (mode === 'read')
+            runId = id(options.runId);
+        else
+            throw new Error('Unsupported run mode');
+        const deadline = Date.now() + 10 * 60 * 1000;
+        let run;
+        while (true) {
+            if (Date.now() >= deadline)
+                throw new Error('Waiting timed out');
+            const response = await request({ method: 'GET', url: `${API}/actor-runs/${runId}`, qs: { waitForFinish: 20 }, json: true });
+            run = response.data;
+            if (run.status === 'SUCCEEDED')
+                break;
+            if (['FAILED', 'TIMED-OUT', 'ABORTED'].includes(run.status))
+                throw new Error('Run did not succeed');
+        }
+        const datasetId = id(run.defaultDatasetId);
+        const dataset = await request({ method: 'GET', url: `${API}/datasets/${datasetId}`, json: true });
+        const rows = [];
+        while (rows.length < maxRows) {
+            const limit = Math.min(1000, maxRows - rows.length);
+            const page = await request({ method: 'GET', url: `${API}/datasets/${datasetId}/items`, qs: { clean: true, offset: rows.length, limit }, json: true });
+            if (!Array.isArray(page) || page.length > limit)
+                throw new Error('Invalid Dataset response');
+            rows.push(...page);
+            if (page.length < limit)
+                break;
+        }
+        const truncated = (dataset.data?.itemCount ?? rows.length) > rows.length;
+        if (options.output === 'full') {
+            const storeId = id(run.defaultKeyValueStoreId);
+            const records = {};
+            for (const key of ['SUMMARY', 'ERRORS']) {
+                try {
+                    records[key] = await request({ method: 'GET', url: `${API}/key-value-stores/${storeId}/records/${key}`, json: true });
+                }
+                catch (error) {
+                    const e = error;
+                    if (e.statusCode === 404 || e.response?.status === 404)
+                        records[key] = null;
+                    else
+                        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'Diagnostics unavailable');
+                }
+            }
+            return [{ runId, datasetId, status: run.status, rows, summary: records.SUMMARY ?? null, errors: records.ERRORS ?? null, truncated }];
+        }
+        return rows.map(row => ({ ...row, _apifyRunId: runId, _apifyTruncated: truncated }));
+    }
+    catch {
+        const safeError = new SafeActorError(context, runId, item);
+        throw safeError;
+    }
+}
+// Keep specialized legacy output modes (including asynchronous start and MCP_RESPONSE).
+async function legacyRequest(context, item, raw) {
+    const options = raw;
+    const controls = context.getNodeParameter('apivaultExecution', item, {});
+    const request = async (value) => context.helpers.httpRequestWithAuthentication.call(context, 'apifyApi', value);
+    if (options.method === 'POST' && options.url.endsWith('/runs')) {
+        const qs = { ...(options.qs ?? {}) };
+        const wait = qs.waitForFinish;
+        delete qs.waitForFinish;
+        const cap = controls.maxTotalChargeUsd ?? (context.getNode().typeVersion < 2 ? undefined : 0.05);
+        if (cap !== undefined) {
+            if (!Number.isFinite(cap) || cap <= 0 || cap > 1000)
+                throw new Error('Invalid event charge cap');
+            qs.maxTotalChargeUsd = cap;
+        }
+        const started = await request({ ...options, qs });
+        if (!wait)
+            return started;
+        const runId = id(started?.data?.id);
+        const deadline = Date.now() + 10 * 60 * 1000;
+        while (Date.now() < deadline) {
+            const result = await request({ method: 'GET', url: `${API}/actor-runs/${runId}`, qs: { waitForFinish: 20 }, json: true });
+            if (result.data.status === 'SUCCEEDED')
+                return result;
+            if (['FAILED', 'TIMED-OUT', 'ABORTED'].includes(result.data.status))
+                throw new Error('Run did not succeed');
+        }
+        throw new Error('Waiting timed out');
+    }
+    if (options.method === 'GET' && /\/datasets\/[A-Za-z0-9_-]+\/items$/.test(options.url)) {
+        const maxRows = controls.maxRows ?? (context.getNode().typeVersion < 2 ? 100000 : 1000);
+        if (!Number.isInteger(maxRows) || maxRows < 1 || maxRows > 100000)
+            throw new Error('Invalid row limit');
+        const rows = [];
+        while (rows.length < maxRows) {
+            const limit = Math.min(1000, maxRows - rows.length);
+            const page = await request({ ...options, qs: { ...(options.qs ?? {}), offset: rows.length, limit } });
+            if (!Array.isArray(page) || page.length > limit)
+                throw new Error('Invalid Dataset response');
+            rows.push(...page);
+            if (page.length < limit)
+                break;
+        }
+        return rows;
+    }
+    return request(options);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "n8n-nodes-apivault-whatsapp-validator",
-  "version": "0.2.0",
-  "description": "n8n community node for WhatsApp Number Validator — backed by the Apify Actor apivault_labs/whatsapp-number-validator. No login. Pay-as-you-go via Apify.",
+  "version": "0.3.0",
+  "description": "Run WhatsApp Number Validator through the hosted Apify Actor and read its results",
   "license": "MIT",
   "homepage": "https://apify.com/apivault_labs/whatsapp-number-validator",
   "keywords": [
@@ -15,20 +15,24 @@
     "workflow-automation"
   ],
   "author": {
-    "name": "apivault_labs"
+    "name": "ApiVault Labs",
+    "email": "68965192+apivault-labs@users.noreply.github.com"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/apivault-labs/n8n-nodes-apivault-whatsapp-validator.git"
+    "url": "git+https://github.com/apivault-labs/apivault-labs.git",
+    "directory": "community-nodes/n8n-nodes-apivault-whatsapp-validator"
   },
   "main": "index.js",
   "scripts": {
-    "build": "tsc && copyfiles \"nodes/**/*.svg\" dist",
-    "dev": "tsc --watch",
+    "build": "tsc && node scripts/copy-icons.cjs",
+    "lint": "n8n-node lint",
+    "test": "node test/contract.cjs",
     "prepublishOnly": "npm run build"
   },
   "files": [
-    "dist"
+    "dist",
+    "examples"
   ],
   "n8n": {
     "n8nNodesApiVersion": 1,
@@ -40,12 +44,12 @@
     ]
   },
   "devDependencies": {
-    "@types/node": "^20.10.0",
-    "copyfiles": "^2.4.1",
-    "n8n-workflow": "*",
-    "typescript": "^5.4.0"
+    "@n8n/node-cli": "0.52.2",
+    "n8n-workflow": "2.16.0",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "@types/node": "^22.0.0"
   },
   "peerDependencies": {
     "n8n-workflow": "*"
   }
-}
+}

package/dist/credentials/ApifyApi.credentials.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ApifyApi.credentials.js","sourceRoot":"","sources":["../../credentials/ApifyApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,QAAQ;IAArB;QACC,SAAI,GAAG,UAAU,CAAC;QAClB,gBAAW,GAAG,WAAW,CAAC;QAC1B,qBAAgB,GAAG,kDAAkD,CAAC;QACtE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4EAA4E;aACzF;SACD,CAAC;QACF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,mCAAmC,EAAE,EAAE;SAC/E,CAAC;QACF,SAAI,GAA2B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC;IACvG,CAAC;CAAA;AApBD,4BAoBC"}

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

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