@vbarbarosh/node-helpers 3.75.0 → 3.76.1

package/src/array_chunk_balanced.test.js

@@ -1,37 +0,0 @@
-const array_chunk_balanced = require('./array_chunk_balanced');
-const assert = require('assert');
-
-describe('array_chunk_balanced', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_chunk_balanced([1]), [[1]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2]), [[1,2]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3]), [[1,2,3]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5], 3, 2), [[1,2,3],[4,5]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6], 3, 2), [[1,2],[3,4],[5,6]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6,7], 3, 2), [[1,2,3],[4,5],[6,7]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5], 3, 3), [[1,2,3,4,5]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6], 3, 3), [[1,2,3],[4,5,6]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6,7], 3, 3), [[1,2,3,4],[5,6,7]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6,7,8], 3, 3), [[1,2,3,4],[5,6,7,8]]);
-    });
-    it('edge: If an array is empty → returns []', function () {
-        assert.deepStrictEqual(array_chunk_balanced([]), []);
-    });
-    it('edge: If there are too few items to satisfy `min_items_per_chunk`, even for 1 chunk, everything goes into a single chunk', function () {
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3], 5, 5), [[1,2,3]]);
-    });
-    it('should never produce more chunks than max_threads', function () {
-        // 12 jobs, max 5 threads, min 2 jobs per thread
-        // Correct result MUST have exactly 5 chunks
-        assert.deepStrictEqual(
-            array_chunk_balanced([1,2,3,4,5,6,7,8,9,10,11,12], 5, 2),
-            [
-                [1,2,3],
-                [4,5,6],
-                [7,8],
-                [9,10],
-                [11,12]
-            ]
-        );
-    });
-});

package/src/array_fps.test.js

@@ -1,72 +0,0 @@
-const array_fps = require('./array_fps');
-const assert = require('assert');
-
-describe('array_fps', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_fps(1, 1), [0]);
-        assert.deepStrictEqual(array_fps(1, 2), [0, 0.99999]);
-        assert.deepStrictEqual(array_fps(1, 3), [0, 0.49999, 0.99999]);
-        assert.deepStrictEqual(array_fps(1, 4), [0, 0.33333, 0.66666, 0.99999]);
-        assert.deepStrictEqual(array_fps(5, 20), [
-            0,       0.0505,  0.10101, 0.15151, 0.20202, 0.25252, 0.30303, 0.35353, 0.40404, 0.45454,
-            0.50505, 0.55555, 0.60606, 0.65656, 0.70707, 0.75757, 0.80808, 0.85858, 0.90909, 0.95959,
-            1.0101,  1.0606,  1.11111, 1.16161, 1.21212, 1.26262, 1.31313, 1.36363, 1.41414, 1.46464,
-            1.51515, 1.56565, 1.61616, 1.66666, 1.71717, 1.76767, 1.81818, 1.86868, 1.91919, 1.96969,
-            2.0202,  2.0707,  2.12121, 2.17171, 2.22222, 2.27272, 2.32323, 2.37373, 2.42424, 2.47474,
-            2.52525, 2.57575, 2.62626, 2.67676, 2.72727, 2.77777, 2.82828, 2.87878, 2.92929, 2.97979,
-            3.0303,  3.0808,  3.13131, 3.18181, 3.23232, 3.28282, 3.33333, 3.38383, 3.43434, 3.48484,
-            3.53535, 3.58585, 3.63636, 3.68686, 3.73737, 3.78787, 3.83838, 3.88888, 3.93939, 3.98989,
-            4.0404,  4.0909,  4.14141, 4.19191, 4.24242, 4.29292, 4.34343, 4.39393, 4.44444, 4.49494,
-            4.54545, 4.59595, 4.64646, 4.69696, 4.74747, 4.79797, 4.84848, 4.89898, 4.94949, 4.99999,
-        ]);
-        assert.deepStrictEqual(array_fps(5, 30), [
-            0,       0.03356, 0.06711, 0.10067, 0.13423, 0.16778, 0.20134, 0.2349,  0.26846, 0.30201,
-            0.33557, 0.36913, 0.40268, 0.43624, 0.4698,  0.50335, 0.53691, 0.57047, 0.60403, 0.63758,
-            0.67114, 0.7047,  0.73825, 0.77181, 0.80537, 0.83892, 0.87248, 0.90604, 0.9396,  0.97315,
-            1.00671, 1.04027, 1.07382, 1.10738, 1.14094, 1.17449, 1.20805, 1.24161, 1.27517, 1.30872,
-            1.34228, 1.37584, 1.40939, 1.44295, 1.47651, 1.51006, 1.54362, 1.57718, 1.61074, 1.64429,
-            1.67785, 1.71141, 1.74496, 1.77852, 1.81208, 1.84563, 1.87919, 1.91275, 1.9463,  1.97986,
-            2.01342, 2.04698, 2.08053, 2.11409, 2.14765, 2.1812,  2.21476, 2.24832, 2.28187, 2.31543,
-            2.34899, 2.38255, 2.4161,  2.44966, 2.48322, 2.51677, 2.55033, 2.58389, 2.61744, 2.651,
-            2.68456, 2.71812, 2.75167, 2.78523, 2.81879, 2.85234, 2.8859,  2.91946, 2.95301, 2.98657,
-            3.02013, 3.05369, 3.08724, 3.1208,  3.15436, 3.18791, 3.22147, 3.25503, 3.28858, 3.32214,
-            3.3557,  3.38925, 3.42281, 3.45637, 3.48993, 3.52348, 3.55704, 3.5906,  3.62415, 3.65771,
-            3.69127, 3.72482, 3.75838, 3.79194, 3.8255,  3.85905, 3.89261, 3.92617, 3.95972, 3.99328,
-            4.02684, 4.06039, 4.09395, 4.12751, 4.16107, 4.19462, 4.22818, 4.26174, 4.29529, 4.32885,
-            4.36241, 4.39596, 4.42952, 4.46308, 4.49664, 4.53019, 4.56375, 4.59731, 4.63086, 4.66442,
-            4.69798, 4.73153, 4.76509, 4.79865, 4.83221, 4.86576, 4.89932, 4.93288, 4.96643, 4.99999,
-        ]);
-        assert.deepStrictEqual(array_fps(5, 60), [
-            0,       0.01672, 0.03344, 0.05017, 0.06689, 0.08361, 0.10033, 0.11706, 0.13378, 0.1505,
-            0.16722, 0.18395, 0.20067, 0.21739, 0.23411, 0.25084, 0.26756, 0.28428, 0.301,   0.31773,
-            0.33445, 0.35117, 0.36789, 0.38461, 0.40134, 0.41806, 0.43478, 0.4515,  0.46823, 0.48495,
-            0.50167, 0.51839, 0.53512, 0.55184, 0.56856, 0.58528, 0.60201, 0.61873, 0.63545, 0.65217,
-            0.66889, 0.68562, 0.70234, 0.71906, 0.73578, 0.75251, 0.76923, 0.78595, 0.80267, 0.8194,
-            0.83612, 0.85284, 0.86956, 0.88629, 0.90301, 0.91973, 0.93645, 0.95318, 0.9699,  0.98662,
-            1.00334, 1.02006, 1.03679, 1.05351, 1.07023, 1.08695, 1.10368, 1.1204,  1.13712, 1.15384,
-            1.17057, 1.18729, 1.20401, 1.22073, 1.23746, 1.25418, 1.2709,  1.28762, 1.30435, 1.32107,
-            1.33779, 1.35451, 1.37123, 1.38796, 1.40468, 1.4214,  1.43812, 1.45485, 1.47157, 1.48829,
-            1.50501, 1.52174, 1.53846, 1.55518, 1.5719,  1.58863, 1.60535, 1.62207, 1.63879, 1.65552,
-            1.67224, 1.68896, 1.70568, 1.7224,  1.73913, 1.75585, 1.77257, 1.78929, 1.80602, 1.82274,
-            1.83946, 1.85618, 1.87291, 1.88963, 1.90635, 1.92307, 1.9398,  1.95652, 1.97324, 1.98996,
-            2.00668, 2.02341, 2.04013, 2.05685, 2.07357, 2.0903,  2.10702, 2.12374, 2.14046, 2.15719,
-            2.17391, 2.19063, 2.20735, 2.22408, 2.2408,  2.25752, 2.27424, 2.29097, 2.30769, 2.32441,
-            2.34113, 2.35785, 2.37458, 2.3913,  2.40802, 2.42474, 2.44147, 2.45819, 2.47491, 2.49163,
-            2.50836, 2.52508, 2.5418,  2.55852, 2.57525, 2.59197, 2.60869, 2.62541, 2.64214, 2.65886,
-            2.67558, 2.6923,  2.70902, 2.72575, 2.74247, 2.75919, 2.77591, 2.79264, 2.80936, 2.82608,
-            2.8428,  2.85953, 2.87625, 2.89297, 2.90969, 2.92642, 2.94314, 2.95986, 2.97658, 2.99331,
-            3.01003, 3.02675, 3.04347, 3.06019, 3.07692, 3.09364, 3.11036, 3.12708, 3.14381, 3.16053,
-            3.17725, 3.19397, 3.2107,  3.22742, 3.24414, 3.26086, 3.27759, 3.29431, 3.31103, 3.32775,
-            3.34447, 3.3612,  3.37792, 3.39464, 3.41136, 3.42809, 3.44481, 3.46153, 3.47825, 3.49498,
-            3.5117,  3.52842, 3.54514, 3.56187, 3.57859, 3.59531, 3.61203, 3.62876, 3.64548, 3.6622,
-            3.67892, 3.69564, 3.71237, 3.72909, 3.74581, 3.76253, 3.77926, 3.79598, 3.8127,  3.82942,
-            3.84615, 3.86287, 3.87959, 3.89631, 3.91304, 3.92976, 3.94648, 3.9632,  3.97993, 3.99665,
-            4.01337, 4.03009, 4.04681, 4.06354, 4.08026, 4.09698, 4.1137,  4.13043, 4.14715, 4.16387,
-            4.18059, 4.19732, 4.21404, 4.23076, 4.24748, 4.26421, 4.28093, 4.29765, 4.31437, 4.3311,
-            4.34782, 4.36454, 4.38126, 4.39798, 4.41471, 4.43143, 4.44815, 4.46487, 4.4816,  4.49832,
-            4.51504, 4.53176, 4.54849, 4.56521, 4.58193, 4.59865, 4.61538, 4.6321,  4.64882, 4.66554,
-            4.68226, 4.69899, 4.71571, 4.73243, 4.74915, 4.76588, 4.7826,  4.79932, 4.81604, 4.83277,
-            4.84949, 4.86621, 4.88293, 4.89966, 4.91638, 4.9331,  4.94982, 4.96655, 4.98327, 4.99999,
-        ]);
-    });
-});

package/src/array_gcd.test.js

@@ -1,10 +0,0 @@
-const array_gcd = require('./array_gcd');
-const assert = require('assert');
-
-describe('array_gcd', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_gcd([1,2,3,4,5]), 1);
-        assert.deepStrictEqual(array_gcd([4,8,16]), 4);
-        assert.deepStrictEqual(array_gcd([300,100,200,300]), 100);
-    });
-});

package/src/array_index.test.js

@@ -1,14 +0,0 @@
-const array_index = require('./array_index');
-const assert = require('assert');
-
-describe('array_index', function () {
-    it('should accept empty array', function () {
-        assert.deepStrictEqual(array_index([]), {});
-    });
-    it('should handle basic input', function () {
-        const a = {uid: 'a'};
-        const b = {uid: 'b'};
-        const c = {uid: 'c'};
-        assert.deepStrictEqual(array_index([a, b, c], v => v.uid), {a, b, c});
-    });
-});

package/src/array_lcm.test.js

@@ -1,12 +0,0 @@
-const array_lcm = require('./array_lcm');
-const assert = require('assert');
-
-describe('array_lcm', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_lcm([1,2,3,4,5]), 60);
-        assert.deepStrictEqual(array_lcm([15,25]), 75);
-        assert.deepStrictEqual(array_lcm([4,6,8]), 24);
-        assert.deepStrictEqual(array_lcm([4,8,16]), 16);
-        assert.deepStrictEqual(array_lcm([300,100,200,300]), 600);
-    });
-});

package/src/array_max.test.js

@@ -1,20 +0,0 @@
-const array_max = require('./array_max');
-const assert = require('assert');
-
-describe('array_max', function () {
-    it('should accept empty array', function () {
-        assert.deepStrictEqual(array_max([]), null);
-    });
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_max([1, 1, 2, 2, 3, 3, 1]), 3);
-        assert.deepStrictEqual(array_max([{x:1},{x:2}], v => v.x), {x: 2});
-    });
-    it('should handle strings', function () {
-        const items = [
-            {id: 1, time: '2025-08-08T05:03:13+00:00'},
-            {id: 2, time: '2025-08-07T05:03:13+00:00'},
-            {id: 3, time: '2025-08-06T05:03:13+00:00'},
-        ];
-        assert.deepStrictEqual(array_max(items, v => v.time), items[0]);
-    });
-});

package/src/array_min.test.js

@@ -1,20 +0,0 @@
-const array_min = require('./array_min');
-const assert = require('assert');
-
-describe('array_min', function () {
-    it('should accept empty array', function () {
-        assert.deepStrictEqual(array_min([]), null);
-    });
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_min([1, 1, 2, 2, 3, 3, 1]), 1);
-        assert.deepStrictEqual(array_min([{x:2},{x:1}], v => v.x), {x: 1});
-    });
-    it('should handle strings', function () {
-        const items = [
-            {id: 1, time: '2025-08-08T05:03:13+00:00'},
-            {id: 2, time: '2025-08-07T05:03:13+00:00'},
-            {id: 3, time: '2025-08-06T05:03:13+00:00'},
-        ];
-        assert.deepStrictEqual(array_min(items, v => v.time), items[2]);
-    });
-});

package/src/array_permutations.test.js

@@ -1,20 +0,0 @@
-const array_permutations = require('./array_permutations');
-const assert = require('assert');
-
-describe('array_permutations', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_permutations([]), [[]]);
-        assert.deepStrictEqual(array_permutations([1,2]), [[1,2],[2,1]]);
-        assert.deepStrictEqual(array_permutations([1,2,3]), [[1,2,3],[2,1,3],[3,1,2],[1,3,2],[2,3,1],[3,2,1]]);
-    });
-    it('should handle k', function () {
-        assert.deepStrictEqual(array_permutations([1,2], 1), [[1],[2]]);
-        assert.deepStrictEqual(array_permutations([1,2,3], 2), [[1,2],[1,3],[2,1],[2,3],[3,1],[3,2]]);
-        assert.deepStrictEqual(array_permutations([1,2,3,4], 3), [
-            [1,2,3],[1,2,4],[1,3,2],[1,3,4],[1,4,2],[1,4,3],
-            [2,1,3],[2,1,4],[2,3,1],[2,3,4],[2,4,1],[2,4,3],
-            [3,1,2],[3,1,4],[3,2,1],[3,2,4],[3,4,1],[3,4,2],
-            [4,1,2],[4,1,3],[4,2,1],[4,2,3],[4,3,1],[4,3,2]
-        ]);
-    });
-});

package/src/array_sort.test.js

@@ -1,85 +0,0 @@
-const array_sort = require('./array_sort');
-const assert = require('assert');
-const fs_path_extname = require('./fs_path_extname');
-
-describe('array_sort', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_sort([5,4,3,2,1], v => [v]), [1,2,3,4,5]);
-        assert.deepStrictEqual(array_sort([5,4,3,2,1], v => [v]), [1,2,3,4,5]);
-        assert.deepStrictEqual(array_sort([{id:5},{id:4},{id:3},{id:2},{id:1}], v => [v.id]), [{id:1},{id:2},{id:3},{id:4},{id:5}]);
-    });
-    it('should handle sort by priorities', function () {
-        assert.deepStrictEqual(array_sort([1,2,3,4,5], v => [[5].indexOf(v) >>> 0]), [5,1,2,3,4]);
-        assert.deepStrictEqual(array_sort([{id:1},{id:2},{id:3},{id:4},{id:5}], v => [[5].indexOf(v.id) >>> 0]), [{id:5},{id:1},{id:2},{id:3},{id:4}]);
-    });
-    it('should handle sort by priorities #2', function () {
-        const files = [
-            {name: 'README.md', size: 1024, type: 'file'},
-            {name: 'package.json', size: 860, type: 'file'},
-            {name: 'src', size: 0, type: 'dir'},
-            {name: 'src/index.js', size: 2048, type: 'file'},
-            {name: 'src/utils', size: 0, type: 'dir'},
-            {name: 'src/utils/helpers.js', size: 1536, type: 'file'},
-            {name: 'node_modules', size: 0, type: 'dir'},
-            {name: 'LICENSE', size: 1078, type: 'file'},
-        ];
-        const expected = [
-            {name: 'node_modules', size: 0, type: 'dir'},
-            {name: 'src', size: 0, type: 'dir'},
-            {name: 'src/utils', size: 0, type: 'dir'},
-            {name: 'LICENSE', size: 1078, type: 'file'},
-            {name: 'README.md', size: 1024, type: 'file'},
-            {name: 'package.json', size: 860, type: 'file'},
-            {name: 'src/index.js', size: 2048, type: 'file'},
-            {name: 'src/utils/helpers.js', size: 1536, type: 'file'},
-        ];
-        const actual = array_sort(files, v => [pri_start(v.type, ['dir']), v.name]);
-        assert.deepStrictEqual(actual, expected);
-    });
-    it('sort by name, directory first; .js, then .txt, then all the reset', function () {
-        const files = [
-            {name: 'docs', type: 'dir', size: 0},
-            {name: 'zeta.txt', type: 'file', size: 1200},
-            {name: 'alpha.js', type: 'file', size: 1500},
-            {name: 'src', type: 'dir', size: 0},
-            {name: 'readme.txt', type: 'file', size: 800},
-            {name: 'beta.js', type: 'file', size: 1600},
-            {name: 'build', type: 'dir', size: 0},
-            {name: 'build.foo.js', type: 'dir', size: 0},
-            {name: 'build.foo.md', type: 'dir', size: 0},
-            {name: 'build.foo.txt', type: 'dir', size: 0},
-            {name: 'notes.md', type: 'file', size: 400},
-            {name: 'zeta.js', type: 'file', size: 1000},
-            {name: 'config', type: 'dir', size: 0},
-        ];
-        const expected = [
-            {name: 'build.foo.js', type: 'dir', size: 0},
-            {name: 'build.foo.txt', type: 'dir', size: 0},
-            {name: 'build', type: 'dir', size: 0},
-            {name: 'build.foo.md', type: 'dir', size: 0},
-            {name: 'config', type: 'dir', size: 0},
-            {name: 'docs', type: 'dir', size: 0},
-            {name: 'src', type: 'dir', size: 0},
-            {name: 'alpha.js', type: 'file', size: 1500},
-            {name: 'beta.js', type: 'file', size: 1600},
-            {name: 'zeta.js', type: 'file', size: 1000},
-            {name: 'readme.txt', type: 'file', size: 800},
-            {name: 'zeta.txt', type: 'file', size: 1200},
-            {name: 'notes.md', type: 'file', size: 400},
-        ];
-        array_sort(files, v => [pri_start(v.type, ['dir']), pri_start(fs_path_extname(v.name), ['.js', '.txt']), v.name])
-        assert.deepStrictEqual(files, expected);
-    });
-});
-
-// priorities.indexOf(v) >>> 0
-function pri_start(value, array)
-{
-    const i = array.indexOf(value);
-    return i === -1 ? array.length : i;
-}
-
-function pri_end(value, array)
-{
-    return array.indexOf(value);
-}

package/src/array_sort_other.test.js

@@ -1,9 +0,0 @@
-const array_sort_other = require('./array_sort_other');
-const assert = require('assert');
-
-describe('array_sort_other', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_sort_other([1,2,3,4,5], v => v, [5]), [5,1,2,3,4]);
-        assert.deepStrictEqual(array_sort_other([{id:1},{id:2},{id:3},{id:4},{id:5}], v => v.id, [5]), [{id:5},{id:1},{id:2},{id:3},{id:4}]);
-    });
-});

package/src/array_sum.test.js

@@ -1,11 +0,0 @@
-const array_sum = require('./array_sum');
-const assert = require('assert');
-
-describe('array_sum', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_sum([1,2,3,4,5]), 15);
-    });
-    it('should cast strings to numbers', function () {
-        assert.deepStrictEqual(array_sum(['1','2','3','4','5']), 15);
-    });
-});

package/src/cli-apps/watchdog.d/connect_close.js

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-
-// 9. Client that connects but sends absolutely NO DATA.
-// Watchdog must NOT treat this as a PING.
-
-const net = require('net');
-
-const SOCKET = process.env.WATCHDOG_SOCKET;
-if (!SOCKET) throw new Error('WATCHDOG_SOCKET missing');
-
-// Connect → immediately destroy the socket → NO write events
-const socket = net.connect(SOCKET, () => {
-    console.log('connected (no ping), closing immediately');
-    socket.destroy(); // IMPORTANT: destroy() does not flush anything
-});
-
-setInterval(() => {}, 1000);

package/src/cli-apps/watchdog.d/connect_close2.js

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-
-// 9. Client that connects but sends absolutely NO DATA.
-// Watchdog must NOT treat this as a PING.
-
-const net = require('net');
-
-const SOCKET = process.env.WATCHDOG_SOCKET;
-if (!SOCKET) throw new Error('WATCHDOG_SOCKET missing');
-
-setInterval(ping, 1000);
-
-function ping()
-{
-    // Connect → immediately destroy the socket → NO write events
-    const socket = net.connect(SOCKET, () => {
-        console.log('connected (no ping), closing immediately');
-        socket.destroy(); // IMPORTANT: destroy() does not flush anything
-    });
-}

package/src/cli-apps/watchdog.d/connect_close3.js

@@ -1,25 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 11. Client sends heartbeats sporadically (sometimes missing)
-// Simulates flaky client.
-
-const net = require('net');
-
-const SOCKET = process.env.WATCHDOG_SOCKET;
-if (!SOCKET) throw new Error('WATCHDOG_SOCKET missing');
-
-setInterval(ping, 1000);
-
-function ping()
-{
-    // Connect → immediately destroy the socket → NO write events
-    const socket = net.connect(SOCKET, () => {
-        if (Math.random() > 0.5) {
-            socket.end('PING');
-        }
-        else {
-            console.log('connected (no ping), closing immediately');
-            socket.destroy(); // IMPORTANT: destroy() does not flush anything
-        }
-    });
-}

package/src/cli-apps/watchdog.d/connect_no_ping.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 8. Client connects but NEVER sends PING
-// Simulates misbehaving client.
-
-const net = require('net');
-
-net.connect(process.env.WATCHDOG_SOCKET, () => {
-    console.log('connected but no ping');
-    // do nothing
-});
-
-setInterval(() => {}, 1000);

package/src/cli-apps/watchdog.d/early_exit.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 4. Client that exits immediately
-// Watchdog must detect child exit first.
-
-console.log('bye');
-process.exit(0);

package/src/cli-apps/watchdog.d/flood.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 7. Client that floods watchdog with 1GB of data
-// Outcome: watchdog must handle MASSIVE reads and still time out.
-
-const fs = require('fs');
-const net = require('net');
-
-const socket = net.connect(process.env.WATCHDOG_SOCKET, () => {
-    console.log('connected');
-    const stream = fs.createReadStream('/dev/zero');
-    stream.pipe(socket);
-});

package/src/cli-apps/watchdog.d/flood2.js

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 7. Client that floods watchdog with 1GB of data
-// Outcome: watchdog must handle MASSIVE reads and still time out.
-
-const fs = require('fs');
-const net = require('net');
-
-const socket = net.connect(process.env.WATCHDOG_SOCKET, () => {
-    console.log('connected');
-    const stream = fs.createReadStream('/dev/zero');
-    stream.pipe(socket).on('error', () => 0);
-});
-
-setInterval(() => {}, 1000);

package/src/cli-apps/watchdog.d/hang.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 5. Client that freezes (event loop blocked)
-// Watchdog will not receive PINGs.
-
-while (true) {
-    // infinite CPU loop
-}

package/src/cli-apps/watchdog.d/huge_delay.js

@@ -1,18 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 10. Client sends heartbeats but with huge delay
-// Tests delayed heartbeat behavior.
-// Expected: watchdog should kill before that.
-
-const net = require('net');
-
-const INTERVAL = Number(process.env.WATCHDOG_INTERVAL || 1000);
-
-const socket = net.connect(process.env.WATCHDOG_SOCKET, () => {
-    console.log('connected');
-
-    setTimeout(() => {
-        console.log('sending late heartbeat');
-        socket.end('PING');
-    }, INTERVAL * 10);
-});

package/src/cli-apps/watchdog.d/ignore_sigterm.js

@@ -1,29 +0,0 @@
-#!/usr/bin/env node
-
-// 1️⃣ Client that ignores SIGTERM
-// Goal: process stays alive after SIGTERM and only dies on SIGKILL (exactly what pid_kill_grace should handle).
-//
-// What this tests for watchdog:
-//   - watchdog sends SIGTERM → process prints “ignored” and keeps running.
-//   - pid_kill_grace waits grace_timeout_ms, sees PID still alive, sends SIGKILL.
-//   - Process must die after SIGKILL.
-//   - Watchdog should log the whole sequence correctly.
-// This is a realistic scenario.
-
-console.log('PID:', process.pid);
-
-// Ignore SIGTERM
-process.on('SIGTERM', function () {
-    console.log('SIGTERM received, but intentionally ignored');
-});
-
-// Still react to SIGINT (Ctrl+C) so you can stop it manually if needed
-process.on('SIGINT', function () {
-    console.log('SIGINT received, exiting');
-    process.exit(130);
-});
-
-// Keep process alive
-setInterval(() => {
-    // simulate work
-}, 1000);

package/src/cli-apps/watchdog.d/late_heartbeat.js

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 11. Client sends heartbeats sporadically (sometimes missing)
-// Simulates flaky client.
-
-const net = require('net');
-
-function randomDelay() {
-    return Math.floor(Math.random() * 5000);
-}
-
-setTimeout(ping, randomDelay());
-
-function ping()
-{
-    const socket = net.connect(process.env.WATCHDOG_SOCKET);
-    socket.on('connect', () => {
-        socket.end('PING');
-        setTimeout(ping, randomDelay());
-    });
-}

package/src/cli-apps/watchdog.d/my-exit-after-2-pings.js

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-
-const Promise = require('bluebird');
-const cli = require('../../cli');
-const ping_socket = require('../../ping_socket');
-
-cli(main);
-
-async function main()
-{
-    for (let iter = 1, last = 2; iter <= last; ++iter) {
-        await ping_socket(process.env.WATCHDOG_SOCKET);
-        await Promise.delay(1000);
-    }
-    console.log('Bye!');
-}

package/src/cli-apps/watchdog.d/my-happy-path.js

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-
-const Promise = require('bluebird');
-const cli = require('@vbarbarosh/node-helpers/src/cli');
-const ping_socket = require('@vbarbarosh/node-helpers/src/ping_socket');
-
-cli(main);
-
-async function main()
-{
-    for (let i = 0; i < 100; ++i) {
-        console.log('[client]', i);
-        await ping_socket(process.env.WATCHDOG_SOCKET);
-        await Promise.delay(1000);
-    }
-}

package/src/cli-apps/watchdog.d/my-ignore-sigterm.js

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-
-const Promise = require('bluebird');
-const cli = require('@vbarbarosh/node-helpers/src/cli');
-const now_human = require('@vbarbarosh/node-helpers/src/now_human');
-
-cli(main);
-
-async function main()
-{
-    process.on('SIGTERM', function () {
-        console.log(`[${now_human()}][ignore-sigterm] SIGTERM, ignoring...`);
-    });
-    process.on('SIGINT', function () {
-        console.log(`[${now_human()}][ignore-sigterm] SIGINT, ignoring...`);
-    });
-
-    for (let iter = 1, last = 100; iter <= last; ++iter) {
-        console.log(`[${now_human()}][ignore-sigterm] ${iter} of ${last}`);
-        await Promise.delay(100);
-    }
-}

package/src/cli-apps/watchdog.d/my-never-ping.js

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-
-const Promise = require('bluebird');
-const cli = require('@vbarbarosh/node-helpers/src/cli');
-const now_human = require('@vbarbarosh/node-helpers/src/now_human');
-
-cli(main);
-
-async function main()
-{
-    for (let iter = 1, last = 100; iter <= last; ++iter) {
-        console.log(`[${now_human()}][never-ping] ${iter} of ${last}`);
-        await Promise.delay(100);
-    }
-}

package/src/cli-apps/watchdog.d/no_heartbeat.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-
-// ❌ 2. Client that never sends heartbeat (expected: watchdog kills it)
-
-setInterval(() => {}, 1000); // alive but no PINGs

package/src/cli-apps/watchdog.d/ok.js

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-
-// ✅ 1. Client that works normally (sends correct PINGs)
-
-const net = require('net');
-
-const SOCKET = process.env.WATCHDOG_SOCKET;
-const INTERVAL = Number(process.env.WATCHDOG_INTERVAL || 1000);
-
-if (!SOCKET) throw new Error('WATCHDOG_SOCKET missing');
-
-setInterval(ping, INTERVAL / 2);
-
-function ping()
-{
-    const socket = net.connect(SOCKET, () => socket.end('PING'));
-}

package/src/cli-apps/watchdog.d/quick-exit-after-2-pings.js

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-
-const Promise = require('bluebird');
-const cli = require('../../cli');
-const ping_socket = require('../../ping_socket');
-
-cli(main);
-
-async function main()
-{
-    for (let iter = 1, last = 2; iter <= last; ++iter) {
-        await ping_socket(process.env.WATCHDOG_SOCKET);
-        await Promise.delay(10);
-    }
-}