@rsdk/common.node 5.7.0-next.6 → 6.0.0-next.1

package/dist/deferred.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+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.Deferred = void 0;
 const timers = __importStar(require("node:timers/promises"));

package/dist/deferred.js.map

@@ -1 +1 @@
-{"version":3,"file":"deferred.js","sourceRoot":"","sources":["../src/deferred.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6DAA+C;AAE/C,MAAa,QAAQ;IACV,OAAO,CAAmB;IAE3B,QAAQ,CAAmD;IAC3D,OAAO,CAA0B;IAEjC,MAAM,CAAK;IACX,OAAO,CAAK;IACZ,YAAY,GAAG,KAAK,CAAC;IACrB,WAAW,GAAG,KAAK,CAAC;IACpB,WAAW,GAAG,KAAK,CAAC;IAE5B;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,SAA2C;QAE3C,OAAO,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAI;QACV,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAS;QACd,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;CACF;AAlED,4BAkEC"}
+{"version":3,"file":"deferred.js","sourceRoot":"","sources":["../src/deferred.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6DAA+C;AAE/C,MAAa,QAAQ;IACV,OAAO,CAAmB;IAE3B,QAAQ,CAAmD;IAC3D,OAAO,CAA0B;IAEjC,MAAM,CAAK;IACX,OAAO,CAAK;IACZ,YAAY,GAAG,KAAK,CAAC;IACrB,WAAW,GAAG,KAAK,CAAC;IACpB,WAAW,GAAG,KAAK,CAAC;IAE5B;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,SAA2C;QAE3C,OAAO,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAI;QACV,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAS;QACd,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;CACF;AAlED,4BAkEC"}

package/dist/index.d.ts

@@ -4,3 +4,5 @@ export { Deferred } from './deferred';
 export { MaybeReadonlyArray } from './types';
 export * from './misc';
 export * from './serialization';
+export * from './parsers';
+export * from './path';

package/dist/index.js

@@ -23,4 +23,6 @@ var deferred_1 = require("./deferred");
 Object.defineProperty(exports, "Deferred", { enumerable: true, get: function () { return deferred_1.Deferred; } });
 __exportStar(require("./misc"), exports);
 __exportStar(require("./serialization"), exports);
+__exportStar(require("./parsers"), exports);
+__exportStar(require("./path"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AAEtB,iEAAsD;AAA7C,oHAAA,WAAW,OAAA;AAEpB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAIjB,yCAAuB;AACvB,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AAEtB,iEAAsD;AAA7C,oHAAA,WAAW,OAAA;AAEpB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAIjB,yCAAuB;AACvB,kDAAgC;AAChC,4CAA0B;AAC1B,yCAAuB"}

package/dist/parsers/fspath.parser.d.ts

@@ -0,0 +1,22 @@
+import type { PropertyParser } from '@rsdk/common';
+/**
+ * Options for FsPathParser
+ */
+export type FsPathParserOptions = {
+    /**
+     * How to check if the file/directory exists:
+     * - 'strict' - check that exact path exists
+     * - 'dirname' - check only that parent directory exists
+     *
+     * Default: 'strict'
+     */
+    check?: 'strict' | 'dirname';
+};
+export declare class FsPathParser implements PropertyParser<string> {
+    private readonly objectType;
+    private readonly options;
+    constructor(objectType: 'file' | 'dir', options?: Partial<FsPathParserOptions>);
+    type(): string;
+    description(): string;
+    parse(value: unknown): string;
+}

package/dist/parsers/fspath.parser.js

@@ -0,0 +1,76 @@
+"use strict";
+/* eslint-disable unicorn/no-nested-ternary */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsPathParser = void 0;
+const common_1 = require("@rsdk/common");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const path_1 = require("../path");
+class FsPathParser {
+    objectType;
+    options;
+    constructor(objectType, options) {
+        this.objectType = objectType;
+        const defaults = {
+            check: 'strict',
+        };
+        this.options = Object.assign(defaults, options || {});
+    }
+    type() {
+        return 'string(fs_path)';
+    }
+    description() {
+        return (0, common_1.text) `
+      Extracts path to file or directory. Checks that object exists on
+      file system and that application has access to it.
+    `;
+    }
+    parse(value) {
+        common_1.Assert.isString(value);
+        const [absolutePath, wasRelative] = path_1.Path.absolutize(value);
+        const pathToCheck = this.options.check === 'dirname'
+            ? node_path_1.default.dirname(absolutePath)
+            : absolutePath;
+        try {
+            if (!(0, node_fs_1.existsSync)(pathToCheck)) {
+                throw new Error('not exists');
+            }
+            (0, node_fs_1.accessSync)(pathToCheck);
+        }
+        catch {
+            const error = [
+                this.options.check === 'dirname' || this.objectType === 'dir'
+                    ? 'Directory'
+                    : 'File',
+                `<${pathToCheck}> not found or can't be accessed!`,
+            ];
+            if (wasRelative) {
+                error.push(' Since you have used relative path, check you current working directory is repos root.');
+            }
+            throw new Error(error.join(' '));
+        }
+        const stat = (0, node_fs_1.lstatSync)(pathToCheck);
+        /**
+         * Otherwise we'll have problems with IsNotDirectoryException
+         * when using symlinks.
+         */
+        if (stat.isSymbolicLink()) {
+            return value;
+        }
+        if (this.options.check === 'dirname' && !stat.isDirectory()) {
+            throw new Error(`<${pathToCheck}> is not a directory!`);
+        }
+        if (this.options.check === 'strict') {
+            const ok = this.objectType === 'dir' ? stat.isDirectory() : stat.isFile();
+            if (!ok) {
+                throw new Error(`<${pathToCheck}> is not a ${this.objectType}!`);
+            }
+        }
+        return value;
+    }
+}
+exports.FsPathParser = FsPathParser;
+//# sourceMappingURL=fspath.parser.js.map

package/dist/parsers/fspath.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fspath.parser.js","sourceRoot":"","sources":["../../src/parsers/fspath.parser.ts"],"names":[],"mappings":";AAAA,8CAA8C;;;;;;AAG9C,yCAA4C;AAC5C,qCAA4D;AAC5D,0DAA6B;AAE7B,kCAA+B;AAgB/B,MAAa,YAAY;IAIJ;IAHF,OAAO,CAAsB;IAE9C,YACmB,UAA0B,EAC3C,OAAsC;QADrB,eAAU,GAAV,UAAU,CAAgB;QAG3C,MAAM,QAAQ,GAAwB;YACpC,KAAK,EAAE,QAAQ;SAChB,CAAC;QAEF,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI;QACF,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,WAAW;QACT,OAAO,IAAA,aAAI,EAAA;;;KAGV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,eAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEvB,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,WAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE3D,MAAM,WAAW,GACf,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAC9B,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,YAAY,CAAC;YAC5B,CAAC,CAAC,YAAY,CAAC;QAEnB,IAAI,CAAC;YACH,IAAI,CAAC,IAAA,oBAAU,EAAC,WAAW,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;YAChC,CAAC;YAED,IAAA,oBAAU,EAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,KAAK,GAAG;gBACZ,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK;oBAC3D,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,MAAM;gBACV,IAAI,WAAW,mCAAmC;aACnD,CAAC;YAEF,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CACR,wFAAwF,CACzF,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,IAAI,GAAG,IAAA,mBAAS,EAAC,WAAW,CAAC,CAAC;QAEpC;;;WAGG;QACH,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,IAAI,WAAW,uBAAuB,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1E,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,MAAM,IAAI,KAAK,CAAC,IAAI,WAAW,cAAc,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAjFD,oCAiFC"}

package/dist/parsers/index.d.ts

@@ -0,0 +1 @@
+export * from './fspath.parser';

package/dist/parsers/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./fspath.parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC"}

package/dist/path.d.ts

@@ -0,0 +1,18 @@
+export declare class Path {
+    /**
+     * Converts a path to an absolute path
+     * @param value - The path to convert (can be relative or absolute)
+     * @returns A tuple containing:
+     *   - The absolute path as a string
+     *   - A boolean indicating whether the input path was relative (true) or absolute (false)
+     */
+    static absolutize(value: string): [string, boolean];
+    /**
+     * Splits a path into directory name and base name components
+     * @param value - The path to split
+     * @returns A tuple containing:
+     *   - The directory path as a string
+     *   - The base filename as a string
+     */
+    static split(value: string): [string, string];
+}

package/dist/path.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.Path = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+class Path {
+    /**
+     * Converts a path to an absolute path
+     * @param value - The path to convert (can be relative or absolute)
+     * @returns A tuple containing:
+     *   - The absolute path as a string
+     *   - A boolean indicating whether the input path was relative (true) or absolute (false)
+     */
+    static absolutize(value) {
+        const normalizedPath = node_path_1.default.normalize(value);
+        const isAbsolute = node_path_1.default.isAbsolute(normalizedPath);
+        const absolutePath = isAbsolute
+            ? normalizedPath
+            : node_path_1.default.join(process.cwd(), normalizedPath);
+        return [absolutePath, !isAbsolute];
+    }
+    /**
+     * Splits a path into directory name and base name components
+     * @param value - The path to split
+     * @returns A tuple containing:
+     *   - The directory path as a string
+     *   - The base filename as a string
+     */
+    static split(value) {
+        return [node_path_1.default.dirname(value), node_path_1.default.basename(value)];
+    }
+}
+exports.Path = Path;
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAE7B,MAAa,IAAI;IACf;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAa;QAC7B,MAAM,cAAc,GAAG,mBAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,mBAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,UAAU;YAC7B,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QAE7C,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa;QACxB,OAAO,CAAC,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;CACF;AA5BD,oBA4BC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsdk/common.node",
-  "version": "5.7.0-next.6",
+  "version": "6.0.0-next.1",
   "description": "Useful common classes, functions and types",
   "license": "Apache License 2.0",
   "publishConfig": {
@@ -14,12 +14,11 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "dotenv": "^16.0.0",
+    "@rsdk/common": "6.0.0-next.1",
+    "dotenv": "^16.3.1",
+    "rxjs": "^7.8.1",
     "toml": "^3.0.0",
     "yaml": "^2.6.1"
   },
-  "peerDependencies": {
-    "rxjs": "^7.1.0"
-  },
-  "gitHead": "287622c55e8717861544f0be502bb37a6b19bbfb"
+  "gitHead": "3114a76df17cf98d6f3cbb8a931599a883af6783"
 }

package/src/index.ts

@@ -8,3 +8,5 @@ export { MaybeReadonlyArray } from './types';
 
 export * from './misc';
 export * from './serialization';
+export * from './parsers';
+export * from './path';

package/src/parsers/fspath.parser.ts

@@ -0,0 +1,105 @@
+/* eslint-disable unicorn/no-nested-ternary */
+
+import type { PropertyParser } from '@rsdk/common';
+import { Assert, text } from '@rsdk/common';
+import { accessSync, existsSync, lstatSync } from 'node:fs';
+import path from 'node:path';
+
+import { Path } from '../path';
+
+/**
+ * Options for FsPathParser
+ */
+export type FsPathParserOptions = {
+  /**
+   * How to check if the file/directory exists:
+   * - 'strict' - check that exact path exists
+   * - 'dirname' - check only that parent directory exists
+   *
+   * Default: 'strict'
+   */
+  check?: 'strict' | 'dirname';
+};
+
+export class FsPathParser implements PropertyParser<string> {
+  private readonly options: FsPathParserOptions;
+
+  constructor(
+    private readonly objectType: 'file' | 'dir',
+    options?: Partial<FsPathParserOptions>,
+  ) {
+    const defaults: FsPathParserOptions = {
+      check: 'strict',
+    };
+
+    this.options = Object.assign(defaults, options || {});
+  }
+
+  type(): string {
+    return 'string(fs_path)';
+  }
+
+  description(): string {
+    return text`
+      Extracts path to file or directory. Checks that object exists on
+      file system and that application has access to it.
+    `;
+  }
+
+  parse(value: unknown): string {
+    Assert.isString(value);
+
+    const [absolutePath, wasRelative] = Path.absolutize(value);
+
+    const pathToCheck =
+      this.options.check === 'dirname'
+        ? path.dirname(absolutePath)
+        : absolutePath;
+
+    try {
+      if (!existsSync(pathToCheck)) {
+        throw new Error('not exists');
+      }
+
+      accessSync(pathToCheck);
+    } catch {
+      const error = [
+        this.options.check === 'dirname' || this.objectType === 'dir'
+          ? 'Directory'
+          : 'File',
+        `<${pathToCheck}> not found or can't be accessed!`,
+      ];
+
+      if (wasRelative) {
+        error.push(
+          ' Since you have used relative path, check you current working directory is repos root.',
+        );
+      }
+
+      throw new Error(error.join(' '));
+    }
+
+    const stat = lstatSync(pathToCheck);
+
+    /**
+     * Otherwise we'll have problems with IsNotDirectoryException
+     * when using symlinks.
+     */
+    if (stat.isSymbolicLink()) {
+      return value;
+    }
+
+    if (this.options.check === 'dirname' && !stat.isDirectory()) {
+      throw new Error(`<${pathToCheck}> is not a directory!`);
+    }
+
+    if (this.options.check === 'strict') {
+      const ok = this.objectType === 'dir' ? stat.isDirectory() : stat.isFile();
+      if (!ok) {
+        throw new Error(`<${pathToCheck}> is not a ${this.objectType}!`);
+      }
+    }
+
+    return value;
+  }
+}

package/src/parsers/index.ts

@@ -0,0 +1 @@
+export * from './fspath.parser';

package/src/path.ts

@@ -0,0 +1,31 @@
+import path from 'node:path';
+
+export class Path {
+  /**
+   * Converts a path to an absolute path
+   * @param value - The path to convert (can be relative or absolute)
+   * @returns A tuple containing:
+   *   - The absolute path as a string
+   *   - A boolean indicating whether the input path was relative (true) or absolute (false)
+   */
+  static absolutize(value: string): [string, boolean] {
+    const normalizedPath = path.normalize(value);
+    const isAbsolute = path.isAbsolute(normalizedPath);
+    const absolutePath = isAbsolute
+      ? normalizedPath
+      : path.join(process.cwd(), normalizedPath);
+
+    return [absolutePath, !isAbsolute];
+  }
+
+  /**
+   * Splits a path into directory name and base name components
+   * @param value - The path to split
+   * @returns A tuple containing:
+   *   - The directory path as a string
+   *   - The base filename as a string
+   */
+  static split(value: string): [string, string] {
+    return [path.dirname(value), path.basename(value)];
+  }
+}