pwd-fs 3.2.4 → 3.3.2

package/dist/powered-file-system/mkdir.test.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const chance_1 = __importDefault(require("chance"));
+const node_test_1 = require("node:test");
+const index_1 = require("../index");
+const test_utils_1 = require("../test-utils");
+/**
+ * Verifies recursive directory creation for absolute and instance-relative roots.
+ */
+(0, node_test_1.describe)('mkdir(src [, options])', () => {
+    const chance = new chance_1.default();
+    let tmpDir = '';
+    let pfs = new index_1.PoweredFileSystem();
+    (0, node_test_1.beforeEach)(() => {
+        tmpDir = (0, test_utils_1.createTmpDir)();
+        pfs = new index_1.PoweredFileSystem();
+        (0, test_utils_1.fmock)({
+            [node_path_1.default.join(tmpDir, 'tings.txt')]: {
+                type: 'file',
+                data: chance.string()
+            }
+        });
+    });
+    (0, node_test_1.afterEach)(() => {
+        (0, test_utils_1.restore)(tmpDir);
+    });
+    (0, node_test_1.it)('Positive: Create directories in the working directory', async () => {
+        const guid = chance.guid();
+        const target = node_path_1.default.join(tmpDir, guid);
+        await pfs.mkdir(target);
+        const exist = node_fs_1.default.existsSync(target);
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('Positive: Make current directory', async () => {
+        const guid = chance.guid();
+        const target = node_path_1.default.join(tmpDir, guid);
+        const nextPfs = new index_1.PoweredFileSystem(target);
+        await nextPfs.mkdir('.');
+        const exist = node_fs_1.default.existsSync(target);
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('Positive: Should work fine with the existing directory', async () => {
+        const guid = chance.guid();
+        const target = node_path_1.default.join(tmpDir, guid);
+        for (let i = 2; i; i--) {
+            await pfs.mkdir(target);
+        }
+        const exist = node_fs_1.default.existsSync(target);
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('Negative: Throw an exception if trying to create a directory in file', async () => {
+        const guid = chance.guid();
+        await node_assert_1.default.rejects(async () => {
+            await pfs.mkdir(node_path_1.default.join(tmpDir, 'tings.txt', guid));
+        });
+    });
+    (0, node_test_1.it)('[sync] Positive: Create directories in the working directory', () => {
+        const guid = chance.guid();
+        const target = node_path_1.default.join(tmpDir, guid);
+        pfs.mkdir(target, {
+            sync: true
+        });
+        const exist = node_fs_1.default.existsSync(target);
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('[sync] Positive: Make current directory', () => {
+        const guid = chance.guid();
+        const target = node_path_1.default.join(tmpDir, guid);
+        const nextPfs = new index_1.PoweredFileSystem(target);
+        nextPfs.mkdir('.', {
+            sync: true
+        });
+        const exist = node_fs_1.default.existsSync(target);
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('[sync] Positive: Should work fine with the existing directory', () => {
+        const guid = chance.guid();
+        const target = node_path_1.default.join(tmpDir, guid);
+        for (let i = 2; i; i--) {
+            pfs.mkdir(target, {
+                sync: true
+            });
+        }
+        const exist = node_fs_1.default.existsSync(target);
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('[sync] Negative: Throw an exception if trying to create a directory in file', () => {
+        const guid = chance.guid();
+        node_assert_1.default.throws(() => {
+            pfs.mkdir(node_path_1.default.join(tmpDir, 'tings.txt', guid), {
+                sync: true
+            });
+        });
+    });
+    (0, node_test_1.it)('[sync] Positive: Absolute pwd should create the target directory itself', () => {
+        const guid = chance.guid();
+        const target = node_path_1.default.join(node_os_1.default.tmpdir(), guid);
+        const nextPfs = new index_1.PoweredFileSystem(target);
+        try {
+            nextPfs.mkdir('.', {
+                sync: true
+            });
+            (0, node_assert_1.default)(node_fs_1.default.existsSync(target));
+        }
+        finally {
+            node_fs_1.default.rmSync(target, { recursive: true, force: true });
+        }
+    });
+});

package/dist/powered-file-system/read.d.ts

@@ -0,0 +1,9 @@
+import type { Flag, PoweredFileSystem } from '../powered-file-system';
+/**
+ * Reads a file relative to `pwd` and preserves Buffer mode when `encoding` is `null`.
+ */
+export declare function read<T extends boolean = false>(this: PoweredFileSystem, src: string, options?: {
+    sync?: T;
+    encoding?: BufferEncoding | null;
+    flag?: Flag;
+}): T extends true ? string | Buffer : Promise<string | Buffer>;

package/dist/powered-file-system/read.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.read = read;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Reads a file relative to `pwd` and preserves Buffer mode when `encoding` is `null`.
+ */
+function read(src, options) {
+    const { sync = false, encoding = 'utf8', flag = 'r' } = options ?? {};
+    const resolved = node_path_1.default.resolve(this.pwd, src);
+    if (sync) {
+        if (encoding === null) {
+            return node_fs_1.default.readFileSync(resolved, { encoding: null, flag });
+        }
+        return node_fs_1.default.readFileSync(resolved, { encoding, flag });
+    }
+    return new Promise((resolve, reject) => {
+        node_fs_1.default.readFile(resolved, { encoding, flag }, (err, raw) => {
+            if (err) {
+                return reject(err);
+            }
+            resolve(raw);
+        });
+    });
+}

package/dist/powered-file-system/read.test.d.ts

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

package/dist/powered-file-system/read.test.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_path_1 = __importDefault(require("node:path"));
+const chance_1 = __importDefault(require("chance"));
+const node_test_1 = require("node:test");
+const index_1 = require("../index");
+const test_utils_1 = require("../test-utils");
+/**
+ * Covers text and binary reads together with failure cases.
+ */
+(0, node_test_1.describe)('read(src [, options])', () => {
+    const chance = new chance_1.default();
+    let sentences = 0;
+    let tmpDir = '';
+    (0, node_test_1.beforeEach)(() => {
+        tmpDir = (0, test_utils_1.createTmpDir)();
+        const tingsContent = chance.paragraph();
+        sentences = tingsContent.length;
+        (0, test_utils_1.fmock)({
+            [node_path_1.default.join(tmpDir, 'tings.txt')]: {
+                type: 'file',
+                data: tingsContent
+            }
+        });
+    });
+    (0, node_test_1.afterEach)(() => {
+        (0, test_utils_1.restore)(tmpDir);
+    });
+    (0, node_test_1.it)('Positive: Must read content of file; String type by default', async () => {
+        const { length } = await index_1.pfs.read(node_path_1.default.join(tmpDir, 'tings.txt'));
+        (0, node_assert_1.default)(length === sentences);
+    });
+    (0, node_test_1.it)('Positive: Must read Buffer content of file when encoding is null', async () => {
+        const buffer = await index_1.pfs.read(node_path_1.default.join(tmpDir, 'tings.txt'), {
+            encoding: null
+        });
+        (0, node_assert_1.default)(buffer instanceof Buffer);
+    });
+    (0, node_test_1.it)('Negative: Throw if resource is not file', async () => {
+        await node_assert_1.default.rejects(async () => {
+            await index_1.pfs.read(tmpDir);
+        });
+    });
+    (0, node_test_1.it)('Negative: Throw if not exists resource', async () => {
+        const guid = chance.guid();
+        await node_assert_1.default.rejects(async () => {
+            await index_1.pfs.read(node_path_1.default.join(tmpDir, guid));
+        });
+    });
+    (0, node_test_1.it)('[sync] Positive: Must read content of file; String type by default', () => {
+        const { length } = index_1.pfs.read(node_path_1.default.join(tmpDir, 'tings.txt'), {
+            sync: true
+        });
+        (0, node_assert_1.default)(length === sentences);
+    });
+    (0, node_test_1.it)('[sync] Positive: Must read Buffer content of file when encoding is null', () => {
+        const buf = index_1.pfs.read(node_path_1.default.join(tmpDir, 'tings.txt'), {
+            sync: true,
+            encoding: null
+        });
+        (0, node_assert_1.default)(buf instanceof Buffer);
+    });
+    (0, node_test_1.it)('[sync] Negative: Throw if not exists resource', () => {
+        const guid = chance.guid();
+        node_assert_1.default.throws(() => {
+            index_1.pfs.read(node_path_1.default.join(tmpDir, guid), {
+                sync: true
+            });
+        });
+    });
+});

package/dist/powered-file-system/readdir.d.ts

@@ -0,0 +1,8 @@
+import type { PoweredFileSystem } from '../powered-file-system';
+/**
+ * Lists directory entries relative to the current instance root.
+ */
+export declare function readdir<T extends boolean = false>(this: PoweredFileSystem, dir: string, options?: {
+    sync?: T;
+    encoding?: BufferEncoding | null;
+}): T extends true ? string[] : Promise<string[]>;

package/dist/powered-file-system/readdir.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readdir = readdir;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Lists directory entries relative to the current instance root.
+ */
+function readdir(dir, options) {
+    const { sync = false, encoding = 'utf8' } = options ?? {};
+    dir = node_path_1.default.resolve(this.pwd, dir);
+    if (sync) {
+        return node_fs_1.default.readdirSync(dir, { encoding });
+    }
+    return new Promise((resolve, reject) => {
+        node_fs_1.default.readdir(dir, { encoding }, (err, list) => {
+            if (err) {
+                return reject(err);
+            }
+            resolve(list);
+        });
+    });
+}

package/dist/powered-file-system/readdir.test.d.ts

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

package/dist/powered-file-system/readdir.test.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_path_1 = __importDefault(require("node:path"));
+const chance_1 = __importDefault(require("chance"));
+const node_test_1 = require("node:test");
+const index_1 = require("../index");
+const test_utils_1 = require("../test-utils");
+/**
+ * Verifies directory listing behavior and invalid-target failures.
+ */
+(0, node_test_1.describe)('readdir(src[, options])', () => {
+    const chance = new chance_1.default();
+    let counter = 0;
+    let tmpDir = '';
+    (0, node_test_1.beforeEach)(() => {
+        tmpDir = (0, test_utils_1.createTmpDir)();
+        const frame = {
+            [node_path_1.default.join(tmpDir, 'tings.txt')]: {
+                type: 'file',
+                data: chance.string()
+            }
+        };
+        counter = chance.natural({ max: 7 });
+        for (let i = 0; i < counter; i++) {
+            frame[node_path_1.default.join(tmpDir, String(i))] = { type: 'directory' };
+        }
+        (0, test_utils_1.fmock)(frame);
+    });
+    (0, node_test_1.afterEach)(() => {
+        (0, test_utils_1.restore)(tmpDir);
+    });
+    (0, node_test_1.it)('Positive: Must return a directory listing', async () => {
+        const { length } = await index_1.pfs.readdir(tmpDir);
+        (0, node_assert_1.default)(counter + 1 === length);
+    });
+    (0, node_test_1.it)('Negative: Throw if resource is not directory', async () => {
+        await node_assert_1.default.rejects(async () => {
+            await index_1.pfs.readdir(node_path_1.default.join(tmpDir, 'tings.txt'));
+        });
+    });
+    (0, node_test_1.it)('Negative: Throw if not exists resource', async () => {
+        const guid = chance.guid();
+        await node_assert_1.default.rejects(async () => {
+            await index_1.pfs.readdir(node_path_1.default.join(tmpDir, guid));
+        });
+    });
+    (0, node_test_1.it)('[sync] Positive: Must return a directory listing', () => {
+        const { length } = index_1.pfs.readdir(tmpDir, {
+            sync: true
+        });
+        (0, node_assert_1.default)(counter + 1 === length);
+    });
+    (0, node_test_1.it)('Negative: Throw if resource is not directory', () => {
+        node_assert_1.default.throws(() => {
+            index_1.pfs.readdir(node_path_1.default.join(tmpDir, 'tings.txt'), {
+                sync: true
+            });
+        });
+    });
+    (0, node_test_1.it)('Negative: Throw if not exists resource', () => {
+        const guid = chance.guid();
+        node_assert_1.default.throws(() => {
+            index_1.pfs.readdir(node_path_1.default.join(tmpDir, guid), {
+                sync: true
+            });
+        });
+    });
+});

package/dist/powered-file-system/remove.d.ts

@@ -0,0 +1,7 @@
+import type { PoweredFileSystem } from '../powered-file-system';
+/**
+ * Removes a path relative to the instance root, preferring native recursive APIs when available.
+ */
+export declare function remove<T extends boolean = false>(this: PoweredFileSystem, src: string, options?: {
+    sync?: T;
+}): T extends true ? void : Promise<void>;

package/dist/powered-file-system/remove.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remove = remove;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const recurse_io_1 = require("../recurse-io");
+const recurse_io_sync_1 = require("../recurse-io-sync");
+/**
+ * Removes a path relative to the instance root, preferring native recursive APIs when available.
+ */
+function remove(src, options) {
+    src = node_path_1.default.resolve(this.pwd, src);
+    const { sync = false } = options ?? {};
+    if (sync) {
+        (0, recurse_io_sync_1.removeSync)(src);
+        return undefined;
+    }
+    return new Promise((resolve, reject) => {
+        const callback = (err) => {
+            if (err) {
+                return reject(err);
+            }
+            resolve();
+        };
+        if ('rm' in node_fs_1.default) {
+            // Prefer the native recursive removal when the runtime supports it.
+            node_fs_1.default.rm(src, { recursive: true }, callback);
+        }
+        else {
+            (0, recurse_io_1.remove)(src, callback);
+        }
+    });
+}

package/dist/powered-file-system/remove.test.d.ts

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

package/dist/powered-file-system/remove.test.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const chance_1 = __importDefault(require("chance"));
+const node_test_1 = require("node:test");
+const index_1 = require("../index");
+const test_utils_1 = require("../test-utils");
+/**
+ * Covers recursive removal, including the symlink edge case.
+ */
+(0, node_test_1.describe)('remove(src [, options])', () => {
+    const chance = new chance_1.default();
+    let tmpDir = '';
+    (0, node_test_1.beforeEach)(() => {
+        tmpDir = (0, test_utils_1.createTmpDir)();
+        const frame = {
+            [node_path_1.default.join(tmpDir, 'tings.txt')]: {
+                type: 'file',
+                data: chance.string()
+            },
+            [node_path_1.default.join(tmpDir, 'digest')]: { type: 'directory' },
+            [node_path_1.default.join(tmpDir, 'flexapp')]: {
+                type: 'symlink',
+                target: node_path_1.default.join(tmpDir, 'tings.txt')
+            },
+            [node_path_1.default.join(tmpDir, 'digest-link')]: {
+                type: 'symlink',
+                target: node_path_1.default.join(tmpDir, 'digest')
+            }
+        };
+        const counter = chance.natural({ max: 7 });
+        for (let i = 0; i < counter; i++) {
+            frame[node_path_1.default.join(tmpDir, String(i))] = { type: 'directory' };
+        }
+        (0, test_utils_1.fmock)(frame);
+    });
+    (0, node_test_1.afterEach)(() => {
+        (0, test_utils_1.restore)(tmpDir);
+    });
+    (0, node_test_1.it)('Positive: Removal a directory with a file', async () => {
+        await index_1.pfs.remove(tmpDir);
+        const exist = node_fs_1.default.existsSync(tmpDir);
+        (0, node_assert_1.default)(exist === false);
+    });
+    (0, node_test_1.it)('Negative: Throw if not exists resource', async () => {
+        const guid = chance.guid();
+        await node_assert_1.default.rejects(async () => {
+            await index_1.pfs.remove(node_path_1.default.join(tmpDir, guid));
+        });
+    });
+    (0, node_test_1.it)('[sync] Positive: Removal a directory with a file', () => {
+        index_1.pfs.remove(tmpDir, {
+            sync: true
+        });
+        const exist = node_fs_1.default.existsSync(tmpDir);
+        (0, node_assert_1.default)(exist === false);
+    });
+    (0, node_test_1.it)('[sync] Negative: Throw if not exists resource', () => {
+        const guid = chance.guid();
+        node_assert_1.default.throws(() => {
+            index_1.pfs.remove(node_path_1.default.join(tmpDir, guid), {
+                sync: true
+            });
+        });
+    });
+    (0, node_test_1.it)('[sync] Positive: Removing a symlink to a directory should remove only the link', () => {
+        index_1.pfs.remove(node_path_1.default.join(tmpDir, 'digest-link'), {
+            sync: true
+        });
+        (0, node_assert_1.default)(node_fs_1.default.existsSync(node_path_1.default.join(tmpDir, 'digest-link')) === false);
+        (0, node_assert_1.default)(node_fs_1.default.existsSync(node_path_1.default.join(tmpDir, 'digest')));
+    });
+});

package/dist/powered-file-system/rename.d.ts

@@ -0,0 +1,7 @@
+import type { PoweredFileSystem } from '../powered-file-system';
+/**
+ * Resolves both paths against the instance root before delegating to Node's rename API.
+ */
+export declare function rename<T extends boolean = false>(this: PoweredFileSystem, src: string, dest: string, options?: {
+    sync?: T;
+}): T extends true ? void : Promise<void>;

package/dist/powered-file-system/rename.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rename = rename;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Resolves both paths against the instance root before delegating to Node's rename API.
+ */
+function rename(src, dest, options) {
+    src = node_path_1.default.resolve(this.pwd, src);
+    dest = node_path_1.default.resolve(this.pwd, dest);
+    const { sync = false } = options ?? {};
+    if (sync) {
+        node_fs_1.default.renameSync(src, dest);
+        return undefined;
+    }
+    return new Promise((resolve, reject) => {
+        node_fs_1.default.rename(src, dest, (err) => {
+            if (err) {
+                return reject(err);
+            }
+            resolve();
+        });
+    });
+}

package/dist/powered-file-system/rename.test.d.ts

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

package/dist/powered-file-system/rename.test.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const chance_1 = __importDefault(require("chance"));
+const node_test_1 = require("node:test");
+const index_1 = require("../index");
+const test_utils_1 = require("../test-utils");
+/**
+ * Verifies move semantics for both files and directories.
+ */
+(0, node_test_1.describe)('rename(src, use [, options])', () => {
+    const chance = new chance_1.default();
+    let tmpDir = '';
+    (0, node_test_1.beforeEach)(() => {
+        tmpDir = (0, test_utils_1.createTmpDir)();
+        (0, test_utils_1.fmock)({
+            [node_path_1.default.join(tmpDir, 'tings.txt')]: {
+                type: 'file',
+                data: chance.string()
+            },
+            [node_path_1.default.join(tmpDir, 'digest')]: { type: 'directory' }
+        });
+    });
+    (0, node_test_1.afterEach)(() => {
+        (0, test_utils_1.restore)(tmpDir);
+    });
+    (0, node_test_1.it)('Positive: Must be recursive rename file', async () => {
+        await index_1.pfs.rename(node_path_1.default.join(tmpDir, 'tings.txt'), node_path_1.default.join(tmpDir, 'newapp.txt'));
+        const exist = node_fs_1.default.existsSync(node_path_1.default.join(tmpDir, 'newapp.txt'));
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('Positive: Must be recursive rename directory', async () => {
+        await index_1.pfs.rename(node_path_1.default.join(tmpDir, 'digest'), node_path_1.default.join(tmpDir, 'newxbase'));
+        const exist = node_fs_1.default.existsSync(node_path_1.default.join(tmpDir, 'newxbase'));
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('Negative: Throw if not exists resource', async () => {
+        const guid = chance.guid();
+        await node_assert_1.default.rejects(async () => {
+            await index_1.pfs.rename(node_path_1.default.join(tmpDir, guid), node_path_1.default.join(tmpDir, 'newxbase'));
+        });
+    });
+    (0, node_test_1.it)('[sync] Positive: Must be recursive rename file', () => {
+        index_1.pfs.rename(node_path_1.default.join(tmpDir, 'tings.txt'), node_path_1.default.join(tmpDir, 'newapp.txt'), {
+            sync: true
+        });
+        const exist = node_fs_1.default.existsSync(node_path_1.default.join(tmpDir, 'newapp.txt'));
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('[sync] Positive: Must be recursive rename directory', () => {
+        index_1.pfs.rename(node_path_1.default.join(tmpDir, 'digest'), node_path_1.default.join(tmpDir, 'newxbase'), {
+            sync: true
+        });
+        const exist = node_fs_1.default.existsSync(node_path_1.default.join(tmpDir, 'newxbase'));
+        (0, node_assert_1.default)(exist);
+    });
+    (0, node_test_1.it)('[sync] Negative: Throw if not exists resource', () => {
+        const guid = chance.guid();
+        node_assert_1.default.throws(() => {
+            index_1.pfs.rename(node_path_1.default.join(tmpDir, guid), node_path_1.default.join(tmpDir, 'newxbase'), {
+                sync: true
+            });
+        });
+    });
+});

package/dist/powered-file-system/stat.d.ts

@@ -0,0 +1,7 @@
+import type { PoweredFileSystem, Stats } from '../powered-file-system';
+/**
+ * Returns `lstat` data so symlinks are reported as links instead of followed targets.
+ */
+export declare function stat<T extends boolean = false>(this: PoweredFileSystem, src: string, options?: {
+    sync?: T;
+}): T extends true ? Stats : Promise<Stats>;

package/dist/powered-file-system/stat.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stat = stat;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Returns `lstat` data so symlinks are reported as links instead of followed targets.
+ */
+function stat(src, options) {
+    const { sync = false } = options ?? {};
+    src = node_path_1.default.resolve(this.pwd, src);
+    if (sync) {
+        return node_fs_1.default.lstatSync(src);
+    }
+    return new Promise((resolve, reject) => {
+        node_fs_1.default.lstat(src, (err, stats) => {
+            if (err) {
+                return reject(err);
+            }
+            resolve(stats);
+        });
+    });
+}

package/dist/powered-file-system/stat.test.d.ts

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