@bsv/wallet-toolbox 2.8.0 → 2.9.0

package/out/src/services/chaintracker/chaintracks/util/NodeBulkFileDataValidator.js

@@ -0,0 +1,207 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeBulkFileDataValidator = void 0;
+const path = __importStar(require("node:path"));
+const node_worker_threads_1 = require("node:worker_threads");
+const BulkFileDataValidatorApi_1 = require("../Api/BulkFileDataValidatorApi");
+/**
+ * Bounded Node worker pool for complete bulk-header verification.
+ *
+ * A bounded private copy transfers to the worker and back without structured
+ * cloning. This preserves the caller's source bytes if a worker crashes while
+ * queue bounds prevent validation copies from consuming unbounded memory.
+ *
+ * @public
+ */
+class NodeBulkFileDataValidator {
+    maxQueue;
+    taskTimeoutMsecs;
+    workerPath;
+    workers = [];
+    queue = [];
+    nextTaskId = 1;
+    destroyed = false;
+    stats = {
+        submitted: 0,
+        completed: 0,
+        failed: 0,
+        rejected: 0,
+        workerRestarts: 0,
+        inFlight: 0,
+        queued: 0,
+        maxQueueDepth: 0,
+        totalValidationMsecs: 0,
+        maxValidationMsecs: 0
+    };
+    constructor(options = {}) {
+        const maxWorkers = positiveInteger(options.maxWorkers ?? 1, 'maxWorkers');
+        this.maxQueue = positiveInteger(options.maxQueue ?? 8, 'maxQueue');
+        this.taskTimeoutMsecs = positiveInteger(options.taskTimeoutMsecs ?? 2 * 60 * 1000, 'taskTimeoutMsecs');
+        this.workerPath = options.workerPath ?? path.join(__dirname, 'BulkFileDataValidator.worker.js');
+        for (let index = 0; index < maxWorkers; index++)
+            this.spawnWorker();
+    }
+    async validate(request) {
+        if (this.destroyed)
+            throw new Error('Bulk-header validator has been destroyed');
+        const idle = this.workers.some(slot => slot.task == null && !slot.terminating);
+        if (!idle && this.queue.length >= this.maxQueue) {
+            this.stats.rejected++;
+            throw new Error(`Bulk-header validation queue is full (${this.maxQueue} waiting objects).`);
+        }
+        return await new Promise((resolve, reject) => {
+            this.stats.submitted++;
+            this.queue.push({ id: this.nextTaskId++, request, startedAt: 0, resolve, reject });
+            this.updateQueueStats();
+            this.dispatch();
+        });
+    }
+    getStats() {
+        return {
+            ...this.stats,
+            inFlight: this.workers.filter(slot => slot.task != null).length,
+            queued: this.queue.length
+        };
+    }
+    async destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        const error = new Error('Bulk-header validator was destroyed');
+        for (const task of this.queue.splice(0))
+            task.reject(error);
+        for (const slot of this.workers) {
+            if (slot.task != null) {
+                clearTimeout(slot.task.timer);
+                slot.task.reject(error);
+                slot.task = undefined;
+            }
+            slot.terminating = true;
+        }
+        await Promise.all(this.workers.map(async (slot) => await slot.worker.terminate()));
+        this.workers.length = 0;
+    }
+    spawnWorker() {
+        if (this.destroyed)
+            return;
+        const worker = new node_worker_threads_1.Worker(this.workerPath);
+        const slot = { worker, terminating: false };
+        worker.on('message', (message) => this.complete(slot, message));
+        worker.on('error', error => this.failWorker(slot, error instanceof Error ? error : new Error(String(error))));
+        worker.on('exit', code => {
+            if (!slot.terminating)
+                this.failWorker(slot, new Error(`Validation worker exited unexpectedly with code ${code}`));
+        });
+        this.workers.push(slot);
+    }
+    dispatch() {
+        for (const slot of this.workers) {
+            if (slot.task != null || slot.terminating)
+                continue;
+            const task = this.queue.shift();
+            if (task == null)
+                break;
+            slot.task = task;
+            task.startedAt = Date.now();
+            task.timer = setTimeout(() => {
+                this.failWorker(slot, new Error(`Bulk-header validation exceeded ${this.taskTimeoutMsecs}ms`));
+            }, this.taskTimeoutMsecs);
+            const data = exactArrayBuffer(task.request.data);
+            slot.worker.postMessage({ id: task.id, request: { ...task.request, data } }, [data]);
+        }
+        this.updateQueueStats();
+    }
+    complete(slot, message) {
+        const task = slot.task;
+        if (task?.id !== message.id)
+            return;
+        clearTimeout(task.timer);
+        slot.task = undefined;
+        const duration = Date.now() - task.startedAt;
+        this.stats.totalValidationMsecs += duration;
+        this.stats.maxValidationMsecs = Math.max(this.stats.maxValidationMsecs, duration);
+        if (message.ok) {
+            this.stats.completed++;
+            task.resolve({ ...message.result, data: new Uint8Array(message.result.data) });
+        }
+        else {
+            this.stats.failed++;
+            const detail = typeof message.error === 'string' ? message.error : (message.error.message ?? 'Validation failed');
+            const error = new BulkFileDataValidatorApi_1.BulkFileDataValidationError(detail, new Uint8Array(message.data));
+            if (typeof message.error !== 'string' && message.error.stack != null)
+                error.stack = message.error.stack;
+            task.reject(error);
+        }
+        this.dispatch();
+    }
+    failWorker(slot, error) {
+        if (slot.terminating)
+            return;
+        slot.terminating = true;
+        const task = slot.task;
+        slot.task = undefined;
+        if (task != null) {
+            clearTimeout(task.timer);
+            this.stats.failed++;
+            task.reject(error);
+        }
+        const index = this.workers.indexOf(slot);
+        if (index >= 0)
+            this.workers.splice(index, 1);
+        this.stats.workerRestarts++;
+        void slot.worker.terminate().finally(() => {
+            if (!this.destroyed) {
+                this.spawnWorker();
+                this.dispatch();
+            }
+        });
+    }
+    updateQueueStats() {
+        this.stats.queued = this.queue.length;
+        this.stats.inFlight = this.workers.filter(slot => slot.task != null).length;
+        this.stats.maxQueueDepth = Math.max(this.stats.maxQueueDepth, this.queue.length);
+    }
+}
+exports.NodeBulkFileDataValidator = NodeBulkFileDataValidator;
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new Error(`${name} must be a positive safe integer`);
+    return value;
+}
+function exactArrayBuffer(data) {
+    return data.slice().buffer;
+}
+//# sourceMappingURL=NodeBulkFileDataValidator.js.map

package/out/src/services/chaintracker/chaintracks/util/NodeBulkFileDataValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeBulkFileDataValidator.js","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/NodeBulkFileDataValidator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/wallet-toolbox",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "sideEffects": false,
   "type": "commonjs",
   "engines": {
@@ -114,7 +114,7 @@
     "format:check": "pnpm --workspace-root exec prettier --check \"packages/wallet/wallet-toolbox/{README.md,jest.config.cjs,package.json,tsconfig*.json}\"",
     "lint": "oxlint src test benchmarks examples operator --deny-warnings",
     "lint:ci": "pnpm lint",
-    "pack:check": "pnpm build && node ../../../scripts/check-package-artifact.mjs . --modes cjs --exports Wallet,WalletSigner,WalletStorageManager,StorageClient,StorageKnex,Services,Setup,WalletPermissionsManager,WalletSettingsManager,LocalChainTracker,FixedWindowBulkFileDownloadBudget,BulkFileDataCacheFs,sdk --entry-exports \"./out/src/sdk=WalletError|WERR_BAD_REQUEST|WERR_INTERNAL|WERR_INVALID_PARAMETER|WERR_UNAUTHORIZED\"",
+    "pack:check": "pnpm build && node ../../../scripts/check-package-artifact.mjs . --modes cjs --exports Wallet,WalletSigner,WalletStorageManager,StorageClient,StorageKnex,Services,Setup,WalletPermissionsManager,WalletSettingsManager,LocalChainTracker,FixedWindowBulkFileDownloadBudget,DurableFileBulkFileDownloadBudget,BulkFileDataCacheFs,NodeBulkFileDataValidator,sdk --entry-exports \"./out/src/sdk=WalletError|WERR_BAD_REQUEST|WERR_INTERNAL|WERR_INVALID_PARAMETER|WERR_UNAUTHORIZED\"",
     "typecheck": "tsc --build --pretty false && tsc --project examples/tsconfig.json --pretty false && tsc --project operator/tsconfig.json --noEmit --pretty false",
     "build": "tsc --build",
     "doc": "ts2md",