n8n-nodes-apivault-newegg 0.1.0 → 0.2.0

package/LICENSE

@@ -1,5 +1,5 @@
-MIT License
-
-Copyright (c) 2026 Apivault
-
-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... THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.
+MIT License
+
+Copyright (c) 2026 Apivault
+
+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... THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -1,14 +1,11 @@
-# n8n-nodes-apivault-newegg
-
-n8n community node for **Newegg Product Scraper**.
-
-Scrape Newegg product pages in real-time — title, price, rating, reviews, brand, availability. Ideal for PC parts, electronics, tech arbitrage.
-
-## Install
-n8n: Settings → Community Nodes → Install → `n8n-nodes-apivault-newegg`
-
-## Credential
-Add an **Apify API** credential with your Apify token (Apify Console → Settings → Integrations). Free account includes monthly credits.
-
----
-Backed by the Apify Actor [`apivault_labs/newegg-product-scraper`](https://apify.com/apivault_labs/newegg-product-scraper).
+# Newegg Product Scraper — n8n node
+
+Calls the hosted [Apify Actor](https://apify.com/apivault_labs/newegg-product-scraper). Requires your own Apify credential; Apify run charges apply.
+
+Install `n8n-nodes-apivault-newegg` through Settings → Community nodes → Install in self-hosted n8n.
+
+## Upgrade compatibility
+
+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.
+
+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/Newegg/Newegg.node.js

@@ -2,194 +2,320 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Newegg = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
-const ACTOR_ID = 'apivault_labs~newegg-product-scraper';
+const actorTransport_1 = require("../helpers/actorTransport");
+const ACTOR_ID = 't0oWsDLob7QOPxcCh';
 class Newegg {
-    constructor() {
-        this.description = {
-            displayName: 'Newegg Product Scraper',
-            name: 'newegg',
-            icon: 'file:newegg.svg',
-            group: ['transform'],
-            version: 1,
-            description: 'Scrape Newegg product pages in real-time — title, price, rating, reviews, brand, availability. Ideal for PC parts, electronics, tech arbitrage.',
-            defaults: { name: 'Newegg Product Scraper' },
-            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
-            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
-            usableAsTool: true,
-            credentials: [{ name: 'apifyApi', required: true }],
-            properties: [
+    description = {
+        "displayName": "Newegg Product Scraper",
+        "name": "newegg",
+        "icon": {
+            "light": "file:newegg.svg",
+            "dark": "file:newegg.svg"
+        },
+        "subtitle": "={{$parameter[\"apivaultMode\"]}}",
+        "group": [
+            "transform"
+        ],
+        "version": [
+            1,
+            2
+        ],
+        "description": "Run Newegg Product Scraper through the hosted Apify Actor and read its results",
+        "defaults": {
+            "name": "Newegg Product Scraper"
+        },
+        "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": "Newegg Product URLs or Item IDs",
                     "name": "productUrls",
-                    "description": "Full Newegg product URLs (https://www.newegg.com/p/N82E16820232869) or bare Item IDs (N82E16820232869). Both formats are accepted. (comma or new-line separated)",
+                    "description": "Actor input: Newegg Product URLs or Item IDs",
                     "type": "string",
                     "default": "",
-                    "required": true
+                    "required": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Product Title",
                     "name": "extractTitle",
-                    "description": "Extract product name / title",
+                    "description": "Actor input: Product Title",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Price",
                     "name": "extractPrice",
-                    "description": "Extract current price",
+                    "description": "Actor input: Price",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Original Price",
                     "name": "extractOriginalPrice",
-                    "description": "Extract original price before discount",
+                    "description": "Actor input: Original Price",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Rating",
                     "name": "extractRating",
-                    "description": "Extract 'eggs' rating (Newegg's star rating 1-5)",
+                    "description": "Actor input: Rating",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Reviews Count",
                     "name": "extractReviewsCount",
-                    "description": "Extract number of reviews",
+                    "description": "Actor input: Reviews Count",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Brand",
                     "name": "extractBrand",
-                    "description": "Extract brand name",
+                    "description": "Actor input: Brand",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Model Number",
                     "name": "extractModel",
-                    "description": "Extract manufacturer model number (Newegg-specific)",
+                    "description": "Actor input: Model Number",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Category",
                     "name": "extractCategory",
-                    "description": "Extract category / breadcrumb",
+                    "description": "Actor input: Category",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Availability",
                     "name": "extractAvailability",
-                    "description": "In Stock / Out of Stock / Sold Out",
+                    "description": "Actor input: Availability",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Seller",
                     "name": "extractSeller",
-                    "description": "Seller / merchant name (Newegg or third-party marketplace)",
+                    "description": "Actor input: Seller",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Shipping Info",
                     "name": "extractShipping",
-                    "description": "Shipping cost / free-shipping flag",
+                    "description": "Actor input: Shipping Info",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Description",
                     "name": "extractDescription",
-                    "description": "Extract product description",
+                    "description": "Actor input: Description",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Main Image",
                     "name": "extractImage",
-                    "description": "Extract main product image URL",
+                    "description": "Actor input: Main Image",
                     "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Max Concurrency",
                     "name": "maxConcurrency",
-                    "description": "Parallel product scrapes (recommended: 2-3)",
+                    "description": "Actor input: Max Concurrency",
                     "type": "number",
                     "default": 3,
                     "typeOptions": {
                         "minValue": 1,
                         "maxValue": 8
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Timeout per product (seconds)",
                     "name": "timeout",
-                    "description": "Max wait per Newegg product page",
+                    "description": "Actor input: Timeout per product (seconds)",
                     "type": "number",
                     "default": 180,
                     "typeOptions": {
                         "minValue": 60,
                         "maxValue": 300
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 }
-            ],
-        };
-    }
+            ]]
+    };
     async execute() {
-        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 = {};
-                {
-                    const _v = this.getNodeParameter("productUrls", i, '');
-                    const _a = _v.split(/[,\n]/).map(s => s.trim()).filter(s => s.length > 0);
-                    if (_a.length)
-                        body["productUrls"] = _a;
-                }
-                body["extractTitle"] = this.getNodeParameter("extractTitle", i);
-                body["extractPrice"] = this.getNodeParameter("extractPrice", i);
-                body["extractOriginalPrice"] = this.getNodeParameter("extractOriginalPrice", i);
-                body["extractRating"] = this.getNodeParameter("extractRating", i);
-                body["extractReviewsCount"] = this.getNodeParameter("extractReviewsCount", i);
-                body["extractBrand"] = this.getNodeParameter("extractBrand", i);
-                body["extractModel"] = this.getNodeParameter("extractModel", i);
-                body["extractCategory"] = this.getNodeParameter("extractCategory", i);
-                body["extractAvailability"] = this.getNodeParameter("extractAvailability", i);
-                body["extractSeller"] = this.getNodeParameter("extractSeller", i);
-                body["extractShipping"] = this.getNodeParameter("extractShipping", i);
-                body["extractDescription"] = this.getNodeParameter("extractDescription", i);
-                body["extractImage"] = this.getNodeParameter("extractImage", i);
-                body["maxConcurrency"] = this.getNodeParameter("maxConcurrency", i);
-                body["timeout"] = this.getNodeParameter("timeout", i);
-                const options = {
-                    method: 'POST',
-                    url: `https://api.apify.com/v2/acts/${ACTOR_ID}/run-sync-get-dataset-items`,
-                    body,
-                    json: true,
-                };
-                const response = await this.helpers.requestWithAuthentication.call(this, 'apifyApi', options);
-                const results = Array.isArray(response) ? response : [response];
+                const body = this.getNodeParameter('apivaultMode', i, 'run') === 'read' ? {} : (() => {
+                    const body = {};
+                    {
+                        const _v = this.getNodeParameter("productUrls", i, '');
+                        const _a = _v.split(/[,\n]/).map(s => s.trim()).filter(s => s.length > 0);
+                        if (_a.length)
+                            body["productUrls"] = _a;
+                    }
+                    body["extractTitle"] = this.getNodeParameter("extractTitle", i);
+                    body["extractPrice"] = this.getNodeParameter("extractPrice", i);
+                    body["extractOriginalPrice"] = this.getNodeParameter("extractOriginalPrice", i);
+                    body["extractRating"] = this.getNodeParameter("extractRating", i);
+                    body["extractReviewsCount"] = this.getNodeParameter("extractReviewsCount", i);
+                    body["extractBrand"] = this.getNodeParameter("extractBrand", i);
+                    body["extractModel"] = this.getNodeParameter("extractModel", i);
+                    body["extractCategory"] = this.getNodeParameter("extractCategory", i);
+                    body["extractAvailability"] = this.getNodeParameter("extractAvailability", i);
+                    body["extractSeller"] = this.getNodeParameter("extractSeller", i);
+                    body["extractShipping"] = this.getNodeParameter("extractShipping", i);
+                    body["extractDescription"] = this.getNodeParameter("extractDescription", i);
+                    body["extractImage"] = this.getNodeParameter("extractImage", i);
+                    body["maxConcurrency"] = this.getNodeParameter("maxConcurrency", i);
+                    body["timeout"] = this.getNodeParameter("timeout", i);
+                    return body;
+                })();
+                const results = await (0, actorTransport_1.runActor)(this, i, ACTOR_ID, body);
                 for (const result of results)
-                    returnData.push({ json: result, pairedItem: { item: i } });
+                    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.Newegg = Newegg;
-//# sourceMappingURL=Newegg.node.js.map

package/dist/nodes/Newegg/newegg.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64"><rect width="64" height="64" rx="12" fill="#4f46e5"/><text x="32" y="40" font-family="Arial" font-size="28" font-weight="700" fill="#fff" text-anchor="middle">N</text></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64"><rect width="64" height="64" rx="12" fill="#4f46e5"/><text x="32" y="40" font-family="Arial" font-size="28" font-weight="700" fill="#fff" text-anchor="middle">N</text></svg>

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/index.js

@@ -1 +1 @@
-module.exports = {};
+module.exports = {};

package/package.json

@@ -1,48 +1,53 @@
-{
-  "name": "n8n-nodes-apivault-newegg",
-  "version": "0.1.0",
-  "description": "n8n community node for Newegg Product Scraper — backed by the Apify Actor apivault_labs/newegg-product-scraper. No login. Pay-as-you-go via Apify.",
-  "license": "MIT",
-  "homepage": "https://apify.com/apivault_labs/newegg-product-scraper",
-  "keywords": [
-    "n8n-community-node-package",
-    "n8n",
-    "newegg",
-    "apify",
-    "no-code",
-    "automation"
-  ],
-  "author": {
-    "name": "apivault_labs"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/apivault-labs/n8n-nodes-apivault-newegg.git"
-  },
-  "main": "index.js",
-  "scripts": {
-    "build": "tsc && copyfiles \"nodes/**/*.svg\" dist",
-    "dev": "tsc --watch"
-  },
-  "files": [
-    "dist"
-  ],
-  "n8n": {
-    "n8nNodesApiVersion": 1,
-    "credentials": [
-      "dist/credentials/ApifyApi.credentials.js"
-    ],
-    "nodes": [
-      "dist/nodes/Newegg/Newegg.node.js"
-    ]
-  },
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "copyfiles": "^2.4.1",
-    "n8n-workflow": "*",
-    "typescript": "^5.4.0"
-  },
-  "peerDependencies": {
-    "n8n-workflow": "*"
-  }
-}
+{
+  "name": "n8n-nodes-apivault-newegg",
+  "version": "0.2.0",
+  "description": "Run Newegg Product Scraper through the hosted Apify Actor and read its results",
+  "license": "MIT",
+  "homepage": "https://apify.com/apivault_labs/newegg-product-scraper",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "newegg",
+    "apify",
+    "no-code",
+    "automation"
+  ],
+  "author": {
+    "name": "ApiVault Labs",
+    "email": "68965192+apivault-labs@users.noreply.github.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/apivault-labs/apivault-labs.git",
+    "directory": "community-nodes/n8n-nodes-apivault-newegg"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && node scripts/copy-icons.cjs",
+    "lint": "n8n-node lint",
+    "test": "node test/contract.cjs",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "examples"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/ApifyApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Newegg/Newegg.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@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;IAAA;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"}

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

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