@aminzer/traverse-directory 1.0.0

package/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Aliaksei Minzer
+
+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, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+### Overview
+
+[NodeJS](https://nodejs.org) utility for recursively iterating over directory contents.
+
+It allows to traverse through all subdirectories and files within a specified directory.
+
+### Installation
+
+```bash
+npm i @aminzer/traverse-directory
+```
+
+### Usage examples
+
+```typescript
+import { traverseDirectory } from '@aminzer/traverse-directory';
+
+await traverseDirectory('/path/to/directory', ({ isFile, relativePath }) => {
+  console.log(`${isFile ? 'File' : 'Directory'} ${relativePath} was found`);
+});
+```
+
+### API
+
+**traverseDirectory**
+
+##### Overview
+
+`traverseDirectory` recursively iterates over the contents of a directory.
+
+```typescript
+traverseDirectory(dirPath, onEachChild);
+```
+
+##### Parameters
+
+* `dirPath` (`string`, required) - path to the directory whose contents should be iterated.
+* `onEachChild` (`function`, required) - callback invoked for each child file and directory.
+
+`onEachChild` callback accepts following arguments:
+* `fsEntry` (`FsEntry`) - currently iterated child file or directory.
+* `additionalArgs` (`object`, optional) - additional callback arguments:
+    * `skipEntryChildrenIteration` (`function`) - call this function within `onEachChild` to skip iterating the children of the current entry.
+
+##### Return value
+
+`Promise` that resolves when the directory traversal is complete.
+
+**FsEntry**
+
+##### Overview
+
+`FsEntry` - class representing File System Entry (file or directory).
+
+```typescript
+import { FsEntry } from '@aminzer/traverse-directory';
+```
+
+Instance properties:
+* `name` (`string`) - name of entry.
+* `absolutePath` (`string`) - absolute path to entry.
+* `relativePath` (`string`) - relative path to entry. It's relative to the directory passed to `traverseDirectory`.
+* `size` (`number`) - size of file in bytes, `0` for directories.
+* `isFile` (`boolean`) - `true` if entry is file.
+* `isDirectory` (`boolean`) - `true` if entry is directory.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default as traverseDirectory } from './traverseDirectory';
+export { FsEntry } from './models';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as traverseDirectory } from './traverseDirectory';
+export { FsEntry } from './models';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/models/FsEntry.d.ts

@@ -0,0 +1,21 @@
+declare class FsEntry {
+    _name: string;
+    _absolutePath: string;
+    _relativePath: string;
+    _isFile: boolean;
+    _size: number;
+    constructor({ name, absolutePath, relativePath, isFile, size, }: {
+        name: string;
+        absolutePath: string;
+        relativePath: string;
+        isFile: boolean;
+        size: number;
+    });
+    get name(): string;
+    get absolutePath(): string;
+    get relativePath(): string;
+    get isFile(): boolean;
+    get isDirectory(): boolean;
+    get size(): number;
+}
+export default FsEntry;

package/dist/models/FsEntry.js

@@ -0,0 +1,34 @@
+class FsEntry {
+    _name;
+    _absolutePath;
+    _relativePath;
+    _isFile;
+    _size;
+    constructor({ name, absolutePath, relativePath, isFile, size, }) {
+        this._name = name;
+        this._absolutePath = absolutePath;
+        this._relativePath = relativePath;
+        this._isFile = isFile;
+        this._size = size;
+    }
+    get name() {
+        return this._name;
+    }
+    get absolutePath() {
+        return this._absolutePath;
+    }
+    get relativePath() {
+        return this._relativePath;
+    }
+    get isFile() {
+        return this._isFile;
+    }
+    get isDirectory() {
+        return !this.isFile;
+    }
+    get size() {
+        return this._size;
+    }
+}
+export default FsEntry;
+//# sourceMappingURL=FsEntry.js.map

package/dist/models/FsEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsEntry.js","sourceRoot":"","sources":["../../src/models/FsEntry.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO;IACX,KAAK,CAAS;IAEd,aAAa,CAAS;IAEtB,aAAa,CAAS;IAEtB,OAAO,CAAU;IAEjB,KAAK,CAAS;IAEd,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,IAAI,GAOL;QACC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,eAAe,OAAO,CAAC"}

package/dist/models/__tests__/FsEntry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/models/__tests__/FsEntry.test.js

@@ -0,0 +1,40 @@
+import assert from 'node:assert';
+import { describe, it } from 'node:test';
+import FsEntry from '../FsEntry';
+describe('models > FsEntry', () => {
+    describe('when entry is file', () => {
+        it('initializes instance with correct fields', () => {
+            const fsEntry = new FsEntry({
+                name: 'the_file.txt',
+                absolutePath: '/absolute/path/to/the_file.txt',
+                relativePath: '/path/to/the_file.txt',
+                isFile: true,
+                size: 32,
+            });
+            assert.strictEqual(fsEntry.name, 'the_file.txt');
+            assert.strictEqual(fsEntry.absolutePath, '/absolute/path/to/the_file.txt');
+            assert.strictEqual(fsEntry.relativePath, '/path/to/the_file.txt');
+            assert.strictEqual(fsEntry.isFile, true);
+            assert.strictEqual(fsEntry.isDirectory, false);
+            assert.strictEqual(fsEntry.size, 32);
+        });
+    });
+    describe('when entry is directory', () => {
+        it('initializes instance with correct fields', () => {
+            const fsEntry = new FsEntry({
+                name: 'the_directory',
+                absolutePath: '/absolute/path/to/the_directory',
+                relativePath: '/path/to/the_directory',
+                isFile: false,
+                size: 0,
+            });
+            assert.strictEqual(fsEntry.name, 'the_directory');
+            assert.strictEqual(fsEntry.absolutePath, '/absolute/path/to/the_directory');
+            assert.strictEqual(fsEntry.relativePath, '/path/to/the_directory');
+            assert.strictEqual(fsEntry.isFile, false);
+            assert.strictEqual(fsEntry.isDirectory, true);
+            assert.strictEqual(fsEntry.size, 0);
+        });
+    });
+});
+//# sourceMappingURL=FsEntry.test.js.map

package/dist/models/__tests__/FsEntry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsEntry.test.js","sourceRoot":"","sources":["../../../src/models/__tests__/FsEntry.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,OAAO,MAAM,YAAY,CAAC;AAEjC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;gBAC1B,IAAI,EAAE,cAAc;gBACpB,YAAY,EAAE,gCAAgC;gBAC9C,YAAY,EAAE,uBAAuB;gBACrC,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,EAAE;aACT,CAAC,CAAC;YAEH,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACjD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,gCAAgC,CAAC,CAAC;YAC3E,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;YAClE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACzC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC/C,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;gBAC1B,IAAI,EAAE,eAAe;gBACrB,YAAY,EAAE,iCAAiC;gBAC/C,YAAY,EAAE,wBAAwB;gBACtC,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,CAAC;aACR,CAAC,CAAC;YAEH,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YAClD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,iCAAiC,CAAC,CAAC;YAC5E,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;YACnE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1C,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC9C,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1 @@
+export { default as FsEntry } from './FsEntry';

package/dist/models/index.js

@@ -0,0 +1,2 @@
+export { default as FsEntry } from './FsEntry';
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/traverseDirectory/__tests__/traverseDirectory.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/traverseDirectory/__tests__/traverseDirectory.test.js

@@ -0,0 +1,289 @@
+import assert from 'node:assert';
+import { join } from 'node:path';
+import { beforeEach, describe, it } from 'node:test';
+import { FsEntry } from '../../models';
+import traverseDirectory from '../traverseDirectory';
+const prepareFsEntries = (entries, basePath) => entries.map((options) => new FsEntry({
+    ...options,
+    absolutePath: join(basePath, options.relativePath),
+}));
+describe('traverseDirectory', () => {
+    describe('when path does not exist', () => {
+        const invalidDirPath = join(import.meta.dirname, 'invalid/path');
+        it('is rejected with error', async () => {
+            await assert.rejects(() => traverseDirectory(invalidDirPath, () => { }), {
+                message: `Directory "${invalidDirPath}" does not exist`,
+            });
+        });
+    });
+    describe('when path corresponds to file', () => {
+        const filePath = import.meta.filename;
+        it('is rejected with error', async () => {
+            await assert.rejects(() => traverseDirectory(filePath, () => { }), {
+                message: `Directory "${filePath}" does not exist`,
+            });
+        });
+    });
+    describe('when path corresponds to directory', () => {
+        const dirPath = join(import.meta.dirname, '../../../test/resources/test_directory');
+        describe('when callback is executed without rejections for each element', () => {
+            let fsEntries = [];
+            let returnValue;
+            beforeEach(async () => {
+                fsEntries = [];
+                returnValue = traverseDirectory(dirPath, (fsEntry) => {
+                    fsEntries.push(fsEntry);
+                });
+            });
+            it('is resolved to "undefined"', async () => {
+                await assert.strictEqual(await returnValue, undefined);
+            });
+            it('triggers callback for each file and directory in source directory tree', async () => {
+                await returnValue;
+                const expectedFsEntries = prepareFsEntries([
+                    {
+                        name: '.dot_file',
+                        relativePath: '.dot_file',
+                        isFile: true,
+                        size: 9,
+                    },
+                    {
+                        name: 'dir_1',
+                        relativePath: 'dir_1',
+                        isFile: false,
+                        size: 0,
+                    },
+                    {
+                        name: 'file_1_1.txt',
+                        relativePath: join('dir_1', 'file_1_1.txt'),
+                        isFile: true,
+                        size: 12,
+                    },
+                    {
+                        name: 'file_1_2.txt',
+                        relativePath: join('dir_1', 'file_1_2.txt'),
+                        isFile: true,
+                        size: 12,
+                    },
+                    {
+                        name: 'dir_2',
+                        relativePath: 'dir_2',
+                        isFile: false,
+                        size: 0,
+                    },
+                    {
+                        name: 'dir_2_1',
+                        relativePath: join('dir_2', 'dir_2_1'),
+                        isFile: false,
+                        size: 0,
+                    },
+                    {
+                        name: 'file_2_1_1.txt',
+                        relativePath: join('dir_2', 'dir_2_1', 'file_2_1_1.txt'),
+                        isFile: true,
+                        size: 14,
+                    },
+                    {
+                        name: 'file_2_1_2.txt',
+                        relativePath: join('dir_2', 'dir_2_1', 'file_2_1_2.txt'),
+                        isFile: true,
+                        size: 14,
+                    },
+                    {
+                        name: 'dir_2_2',
+                        relativePath: join('dir_2', 'dir_2_2'),
+                        isFile: false,
+                        size: 0,
+                    },
+                    {
+                        name: 'file_2_2_1.txt',
+                        relativePath: join('dir_2', 'dir_2_2', 'file_2_2_1.txt'),
+                        isFile: true,
+                        size: 14,
+                    },
+                    {
+                        name: 'file_2_2_2.txt',
+                        relativePath: join('dir_2', 'dir_2_2', 'file_2_2_2.txt'),
+                        isFile: true,
+                        size: 14,
+                    },
+                    {
+                        name: 'file_2_1.txt',
+                        relativePath: join('dir_2', 'file_2_1.txt'),
+                        isFile: true,
+                        size: 12,
+                    },
+                    {
+                        name: 'file_2_2.txt',
+                        relativePath: join('dir_2', 'file_2_2.txt'),
+                        isFile: true,
+                        size: 12,
+                    },
+                    {
+                        name: 'file_1.txt',
+                        relativePath: 'file_1.txt',
+                        isFile: true,
+                        size: 10,
+                    },
+                    {
+                        name: 'file_2.txt',
+                        relativePath: 'file_2.txt',
+                        isFile: true,
+                        size: 10,
+                    },
+                ], dirPath);
+                assert.ok(fsEntries.every((fsEntry) => fsEntry instanceof FsEntry));
+                assert.deepStrictEqual(fsEntries, expectedFsEntries);
+            });
+        });
+        describe('when async callback is passed', () => {
+            let returnValue;
+            const logs = [];
+            beforeEach(async () => {
+                returnValue = traverseDirectory(dirPath, async ({ name }) => {
+                    logs.push(`Processing ${name}`);
+                    await new Promise((resolve) => setTimeout(resolve, 1));
+                    logs.push(`Processed ${name}`);
+                });
+            });
+            it('waits current entry Promise resolving before calling callback on next entry', async () => {
+                await returnValue;
+                const expectedLogs = [
+                    'Processing .dot_file',
+                    'Processed .dot_file',
+                    'Processing dir_1',
+                    'Processed dir_1',
+                    'Processing file_1_1.txt',
+                    'Processed file_1_1.txt',
+                    'Processing file_1_2.txt',
+                    'Processed file_1_2.txt',
+                    'Processing dir_2',
+                    'Processed dir_2',
+                    'Processing dir_2_1',
+                    'Processed dir_2_1',
+                    'Processing file_2_1_1.txt',
+                    'Processed file_2_1_1.txt',
+                    'Processing file_2_1_2.txt',
+                    'Processed file_2_1_2.txt',
+                    'Processing dir_2_2',
+                    'Processed dir_2_2',
+                    'Processing file_2_2_1.txt',
+                    'Processed file_2_2_1.txt',
+                    'Processing file_2_2_2.txt',
+                    'Processed file_2_2_2.txt',
+                    'Processing file_2_1.txt',
+                    'Processed file_2_1.txt',
+                    'Processing file_2_2.txt',
+                    'Processed file_2_2.txt',
+                    'Processing file_1.txt',
+                    'Processed file_1.txt',
+                    'Processing file_2.txt',
+                    'Processed file_2.txt',
+                ];
+                assert.deepStrictEqual(logs, expectedLogs);
+            });
+        });
+        describe('when callback is rejected for some file or directory in source directory tree', () => {
+            let fsEntries = [];
+            let returnValue;
+            beforeEach(async () => {
+                fsEntries = [];
+                returnValue = traverseDirectory(dirPath, (fsEntry) => {
+                    if (fsEntry.name === 'file_1_2.txt') {
+                        throw new Error('Test error');
+                    }
+                    fsEntries.push(fsEntry);
+                });
+            });
+            it('is rejected with corresponding error', async () => {
+                await assert.rejects(() => returnValue, { message: 'Test error' });
+            });
+            it("doesn't trigger callback after rejected file or directory", async () => {
+                try {
+                    await returnValue;
+                }
+                catch {
+                    // ignored
+                }
+                const expectedFsEntries = prepareFsEntries([
+                    {
+                        name: '.dot_file',
+                        relativePath: '.dot_file',
+                        isFile: true,
+                        size: 9,
+                    },
+                    {
+                        name: 'dir_1',
+                        relativePath: 'dir_1',
+                        isFile: false,
+                        size: 0,
+                    },
+                    {
+                        name: 'file_1_1.txt',
+                        relativePath: join('dir_1', 'file_1_1.txt'),
+                        isFile: true,
+                        size: 12,
+                    },
+                ], dirPath);
+                assert.deepStrictEqual(fsEntries, expectedFsEntries);
+            });
+        });
+        describe('when "skipEntryChildrenIteration" is called for some directory', () => {
+            it("doesn't trigger callback for children of that directory", async () => {
+                const fsEntries = [];
+                await traverseDirectory(dirPath, (fsEntry, { skipEntryChildrenIteration }) => {
+                    fsEntries.push(fsEntry);
+                    if (fsEntry.name === 'dir_2') {
+                        skipEntryChildrenIteration();
+                    }
+                });
+                const expectedFsEntries = prepareFsEntries([
+                    {
+                        name: '.dot_file',
+                        relativePath: '.dot_file',
+                        isFile: true,
+                        size: 9,
+                    },
+                    {
+                        name: 'dir_1',
+                        relativePath: 'dir_1',
+                        isFile: false,
+                        size: 0,
+                    },
+                    {
+                        name: 'file_1_1.txt',
+                        relativePath: join('dir_1', 'file_1_1.txt'),
+                        isFile: true,
+                        size: 12,
+                    },
+                    {
+                        name: 'file_1_2.txt',
+                        relativePath: join('dir_1', 'file_1_2.txt'),
+                        isFile: true,
+                        size: 12,
+                    },
+                    {
+                        name: 'dir_2',
+                        relativePath: 'dir_2',
+                        isFile: false,
+                        size: 0,
+                    },
+                    {
+                        name: 'file_1.txt',
+                        relativePath: 'file_1.txt',
+                        isFile: true,
+                        size: 10,
+                    },
+                    {
+                        name: 'file_2.txt',
+                        relativePath: 'file_2.txt',
+                        isFile: true,
+                        size: 10,
+                    },
+                ], dirPath);
+                assert.deepStrictEqual(fsEntries, expectedFsEntries);
+            });
+        });
+    });
+});
+//# sourceMappingURL=traverseDirectory.test.js.map

package/dist/traverseDirectory/__tests__/traverseDirectory.test.js.map

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

package/dist/traverseDirectory/index.d.ts

@@ -0,0 +1 @@
+export { default } from './traverseDirectory';

package/dist/traverseDirectory/index.js

@@ -0,0 +1,2 @@
+export { default } from './traverseDirectory';
+//# sourceMappingURL=index.js.map

package/dist/traverseDirectory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/traverseDirectory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/traverseDirectory/traverseDirectory.d.ts

@@ -0,0 +1,3 @@
+import { OnEachChild } from './types';
+declare const traverseDirectory: (dirPath: string, onEachChild: OnEachChild) => Promise<void>;
+export default traverseDirectory;

package/dist/traverseDirectory/traverseDirectory.js

@@ -0,0 +1,10 @@
+import { directoryExist } from '../utils/fs';
+import traverseDirectoryRecursive from './traverseDirectoryRecursive';
+const traverseDirectory = async (dirPath, onEachChild) => {
+    if (!(await directoryExist(dirPath))) {
+        throw new Error(`Directory "${dirPath}" does not exist`);
+    }
+    await traverseDirectoryRecursive(dirPath, null, onEachChild);
+};
+export default traverseDirectory;
+//# sourceMappingURL=traverseDirectory.js.map

package/dist/traverseDirectory/traverseDirectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverseDirectory.js","sourceRoot":"","sources":["../../src/traverseDirectory/traverseDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,0BAA0B,MAAM,8BAA8B,CAAC;AAGtE,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAe,EAAE,WAAwB,EAAiB,EAAE;IAC3F,IAAI,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,cAAc,OAAO,kBAAkB,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,0BAA0B,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC/D,CAAC,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/traverseDirectory/traverseDirectoryRecursive.d.ts

@@ -0,0 +1,3 @@
+import { OnEachChild } from './types';
+declare const traverseDirectoryRecursive: (absoluteDirPath: string, relativeDirPath: string | null, onEachChild: OnEachChild) => Promise<void>;
+export default traverseDirectoryRecursive;

package/dist/traverseDirectory/traverseDirectoryRecursive.js

@@ -0,0 +1,31 @@
+import { join } from 'node:path';
+import { stat, readdir } from 'node:fs/promises';
+import { FsEntry } from '../models';
+import { iterateInSeries } from '../utils/iteration';
+const traverseDirectoryRecursive = async (absoluteDirPath, relativeDirPath, onEachChild) => {
+    const entries = await readdir(absoluteDirPath);
+    await iterateInSeries(entries, async (name) => {
+        const absolutePath = join(absoluteDirPath, name);
+        const relativePath = relativeDirPath ? join(relativeDirPath, name) : name;
+        const stats = await stat(absolutePath);
+        const isFile = stats.isFile();
+        const size = isFile ? stats.size : 0;
+        const fsEntry = new FsEntry({
+            name,
+            absolutePath,
+            relativePath,
+            isFile,
+            size,
+        });
+        let iterateEntry = fsEntry.isDirectory;
+        const skipEntryChildrenIteration = () => {
+            iterateEntry = false;
+        };
+        await onEachChild(fsEntry, { skipEntryChildrenIteration });
+        if (iterateEntry) {
+            await traverseDirectoryRecursive(absolutePath, relativePath, onEachChild);
+        }
+    });
+};
+export default traverseDirectoryRecursive;
+//# sourceMappingURL=traverseDirectoryRecursive.js.map

package/dist/traverseDirectory/traverseDirectoryRecursive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverseDirectoryRecursive.js","sourceRoot":"","sources":["../../src/traverseDirectory/traverseDirectoryRecursive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,0BAA0B,GAAG,KAAK,EACtC,eAAuB,EACvB,eAA8B,EAC9B,WAAwB,EACT,EAAE;IACjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IAE/C,MAAM,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE;QACpD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAE1E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAErC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;YAC1B,IAAI;YACJ,YAAY;YACZ,YAAY;YACZ,MAAM;YACN,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;QAEvC,MAAM,0BAA0B,GAAG,GAAG,EAAE;YACtC,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,WAAW,CAAC,OAAO,EAAE,EAAE,0BAA0B,EAAE,CAAC,CAAC;QAE3D,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,0BAA0B,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/dist/traverseDirectory/types.d.ts

@@ -0,0 +1,6 @@
+import { FsEntry } from '../models';
+type OnEachChildOptions = {
+    skipEntryChildrenIteration: () => void;
+};
+export type OnEachChild = (fsEntry: FsEntry, options: OnEachChildOptions) => void | Promise<void>;
+export {};

package/dist/traverseDirectory/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/traverseDirectory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/traverseDirectory/types.ts"],"names":[],"mappings":""}

package/dist/utils/fs/__tests__/directoryExist.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/fs/__tests__/directoryExist.test.js

@@ -0,0 +1,25 @@
+import assert from 'node:assert';
+import { join } from 'node:path';
+import { describe, it } from 'node:test';
+import directoryExist from '../directoryExist';
+describe('utils > fs > directoryExist', () => {
+    describe('when path does not exist', () => {
+        const invalidPath = join(import.meta.dirname, 'invalid/path');
+        it('returns false', async () => {
+            assert.strictEqual(await directoryExist(invalidPath), false);
+        });
+    });
+    describe('when path corresponds to file', () => {
+        const filePath = import.meta.filename;
+        it('returns false', async () => {
+            assert.strictEqual(await directoryExist(filePath), false);
+        });
+    });
+    describe('when path corresponds to directory', () => {
+        const dirPath = import.meta.dirname;
+        it('returns true', async () => {
+            assert.strictEqual(await directoryExist(dirPath), true);
+        });
+    });
+});
+//# sourceMappingURL=directoryExist.test.js.map

package/dist/utils/fs/__tests__/directoryExist.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directoryExist.test.js","sourceRoot":"","sources":["../../../../src/utils/fs/__tests__/directoryExist.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,cAAc,MAAM,mBAAmB,CAAC;AAE/C,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAE9D,EAAE,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;YAC7B,MAAM,CAAC,WAAW,CAAC,MAAM,cAAc,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QAEtC,EAAE,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;YAC7B,MAAM,CAAC,WAAW,CAAC,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAClD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAEpC,EAAE,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;YAC5B,MAAM,CAAC,WAAW,CAAC,MAAM,cAAc,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/fs/directoryExist.d.ts

@@ -0,0 +1,2 @@
+declare const directoryExist: (path: string) => Promise<boolean>;
+export default directoryExist;

package/dist/utils/fs/directoryExist.js

@@ -0,0 +1,12 @@
+import { stat } from 'node:fs/promises';
+const directoryExist = async (path) => {
+    try {
+        const stats = await stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+};
+export default directoryExist;
+//# sourceMappingURL=directoryExist.js.map

package/dist/utils/fs/directoryExist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directoryExist.js","sourceRoot":"","sources":["../../../src/utils/fs/directoryExist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,cAAc,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IAC9D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/utils/fs/index.d.ts

@@ -0,0 +1 @@
+export { default as directoryExist } from './directoryExist';

package/dist/utils/fs/index.js

@@ -0,0 +1,2 @@
+export { default as directoryExist } from './directoryExist';
+//# sourceMappingURL=index.js.map

package/dist/utils/fs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/fs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/iteration/__tests__/iterateInSeries.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/iteration/__tests__/iterateInSeries.test.js

@@ -0,0 +1,65 @@
+import assert from 'node:assert';
+import { beforeEach, describe, it } from 'node:test';
+import iterateInSeries from '../iterateInSeries';
+describe('utils > iteration > iterateInSeries', () => {
+    let sourceArray = [];
+    let logs = [];
+    beforeEach(() => {
+        sourceArray = ['a', 'b', 'c'];
+        logs = [];
+    });
+    describe('when sync callback is passed', () => {
+        beforeEach(async () => {
+            await iterateInSeries(sourceArray, (element, index) => {
+                logs.push(`processed ${element}:${index}`);
+            });
+        });
+        it('calls callback function for each array element in series', () => {
+            assert.deepStrictEqual(logs, ['processed a:0', 'processed b:1', 'processed c:2']);
+        });
+    });
+    describe('when async callback is passed', () => {
+        beforeEach(async () => {
+            await iterateInSeries(sourceArray, async (element) => {
+                logs.push(`processing ${element}`);
+                await new Promise((resolve) => setTimeout(resolve, 1));
+                logs.push(`processed ${element}`);
+            });
+        });
+        it('waits current element Promise resolving before calling callback on next element', () => {
+            assert.deepStrictEqual(logs, [
+                'processing a',
+                'processed a',
+                'processing b',
+                'processed b',
+                'processing c',
+                'processed c',
+            ]);
+        });
+    });
+    describe('when callback rejects with error for some element', () => {
+        let returnValue;
+        beforeEach(async () => {
+            returnValue = iterateInSeries(['a', 'b', 'c'], async (element) => {
+                logs.push(`processing ${element}`);
+                if (element === 'b') {
+                    throw new Error(`Test error on element ${element}`);
+                }
+                logs.push(`processed ${element}`);
+            });
+        });
+        it('is rejected with corresponding error', async () => {
+            await assert.rejects(() => returnValue, { message: 'Test error on element b' });
+        });
+        it("doesn't trigger callback after rejected element", async () => {
+            try {
+                await returnValue;
+            }
+            catch {
+                // ignored
+            }
+            assert.deepStrictEqual(logs, ['processing a', 'processed a', 'processing b']);
+        });
+    });
+});
+//# sourceMappingURL=iterateInSeries.test.js.map

package/dist/utils/iteration/__tests__/iterateInSeries.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterateInSeries.test.js","sourceRoot":"","sources":["../../../../src/utils/iteration/__tests__/iterateInSeries.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/iteration/index.d.ts

@@ -0,0 +1 @@
+export { default as iterateInSeries } from './iterateInSeries';

package/dist/utils/iteration/index.js

@@ -0,0 +1,2 @@
+export { default as iterateInSeries } from './iterateInSeries';
+//# sourceMappingURL=index.js.map

package/dist/utils/iteration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/iteration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/utils/iteration/iterateInSeries.d.ts

@@ -0,0 +1,2 @@
+declare const iterateInSeries: <T>(array: T[], callback: (element: T, index?: number) => void | Promise<void>) => Promise<void>;
+export default iterateInSeries;

package/dist/utils/iteration/iterateInSeries.js

@@ -0,0 +1,7 @@
+const iterateInSeries = async (array, callback) => {
+    for (let index = 0; index < array.length; index += 1) {
+        await callback(array[index], index);
+    }
+};
+export default iterateInSeries;
+//# sourceMappingURL=iterateInSeries.js.map

package/dist/utils/iteration/iterateInSeries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterateInSeries.js","sourceRoot":"","sources":["../../../src/utils/iteration/iterateInSeries.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,KAAK,EAC3B,KAAU,EACV,QAA8D,EAC/C,EAAE;IACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@aminzer/traverse-directory",
+  "version": "1.0.0",
+  "description": "Utility for directory child entries recursive iteration",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "keywords": [
+    "traverse",
+    "directory",
+    "fs",
+    "filesystem",
+    "file",
+    "folder",
+    "iterate",
+    "recursion",
+    "recursive"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aminzer/traverse-directory.git"
+  },
+  "license": "MIT",
+  "author": "aminzer",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "build:watch": "npm run build -- --watch",
+    "clean": "rimraf dist",
+    "codestyle": "run-p lint typescript:check",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "npm run lint -- --fix",
+    "prepare": "npm run rebuild",
+    "rebuild": "run-s clean build",
+    "test": "tsx --test src/**/*.test.ts",
+    "typescript:check": "tsc --project tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.36.0",
+    "@types/node": "^24.5.2",
+    "eslint": "^9.36.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "npm-run-all": "^4.1.5",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.44.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}