@socketsecurity/lib 6.0.7 → 6.0.8

package/dist/packages/edit-class.js

@@ -18,7 +18,7 @@ let src_external__npmcli_package_json_lib_sort = require("../external/@npmcli/pa
 /**
 * @file The `EditablePackageJson` class factory. Split out of
 *   `packages/edit.ts` for size hygiene. Wraps `@npmcli/package-json` with
-*   Socket-specific knobs: path tracking, a `_canSave` guard for content-only
+*   Socket-specific knobs: path tracking, a `canSave` guard for content-only
 *   instances, async + sync save paths that honor `EditablePackageJsonOptions`
 *   formatting.
 *
@@ -40,28 +40,28 @@ function getEditablePackageJsonClass() {
 		static fixSteps = src_external__npmcli_package_json.default.fixSteps;
 		static normalizeSteps = src_external__npmcli_package_json.default.normalizeSteps;
 		static prepareSteps = src_external__npmcli_package_json.default.prepareSteps;
-		_canSave = true;
-		_path = void 0;
-		_readFileContent = "";
-		_readFileJson = void 0;
+		canSave = true;
+		pkgPath = void 0;
+		readFileContent = "";
+		readFileJson = void 0;
 		get content() {
 			return super.content;
 		}
 		get filename() {
-			const path = this._path;
-			if (!path) return "";
-			if (require_primordials_string.StringPrototypeEndsWith(path, "package.json")) return path;
-			return require_node_path.getNodePath().join(path, "package.json");
+			const pkgPath = this.pkgPath;
+			if (!pkgPath) return "";
+			if (require_primordials_string.StringPrototypeEndsWith(pkgPath, "package.json")) return pkgPath;
+			return require_node_path.getNodePath().join(pkgPath, "package.json");
 		}
 		static async create(path, opts = {}) {
 			const p = new cachedEditablePackageJsonClass();
 			await p.create(path);
 			return opts.data ? p.update(opts.data) : p;
 		}
-		static async fix(path, opts) {
+		static async fix(path, options) {
 			const p = new cachedEditablePackageJsonClass();
 			await p.load(path, true);
-			return await p.fix(opts);
+			return await p.fix(options);
 		}
 		static async load(path, opts = {}) {
 			const p = new cachedEditablePackageJsonClass();
@@ -73,19 +73,19 @@ function getEditablePackageJsonClass() {
 				return p.create(path);
 			}
 		}
-		static async normalize(path, opts) {
+		static async normalize(path, options) {
 			const p = new cachedEditablePackageJsonClass();
 			await p.load(path);
-			return await p.normalize(opts);
+			return await p.normalize(options);
 		}
-		static async prepare(path, opts) {
+		static async prepare(path, options) {
 			const p = new cachedEditablePackageJsonClass();
 			await p.load(path, true);
-			return await p.prepare(opts);
+			return await p.prepare(options);
 		}
 		create(path) {
 			super.create(path);
-			this._path = path;
+			this.pkgPath = path;
 			return this;
 		}
 		async fix(opts = {}) {
@@ -94,7 +94,7 @@ function getEditablePackageJsonClass() {
 		}
 		fromContent(data) {
 			super.fromContent(data);
-			this._canSave = false;
+			this.canSave = false;
 			return this;
 		}
 		fromJSON(data) {
@@ -102,11 +102,11 @@ function getEditablePackageJsonClass() {
 			return this;
 		}
 		async load(path, create) {
-			this._path = path;
+			this.pkgPath = path;
 			const { promises: fsPromises } = require_node_fs.getNodeFs();
 			let parseErr;
 			try {
-				this._readFileContent = await (0, src_external__npmcli_package_json_lib_read_package.read)(this.filename);
+				this.readFileContent = await (0, src_external__npmcli_package_json_lib_read_package.read)(this.filename);
 			} catch (e) {
 				if (!create) throw e;
 				parseErr = e;
@@ -124,11 +124,11 @@ function getEditablePackageJsonClass() {
 				} catch {
 					throw parseErr;
 				}
-				this._canSave = false;
+				this.canSave = false;
 				return this;
 			}
-			this.fromJSON(this._readFileContent);
-			this._readFileJson = (0, src_external__npmcli_package_json_lib_read_package.parse)(this._readFileContent);
+			this.fromJSON(this.readFileContent);
+			this.readFileJson = (0, src_external__npmcli_package_json_lib_read_package.parse)(this.readFileContent);
 			return this;
 		}
 		async normalize(opts = {}) {
@@ -136,15 +136,19 @@ function getEditablePackageJsonClass() {
 			return this;
 		}
 		get path() {
-			return this._path;
+			return this.pkgPath;
 		}
 		async prepare(opts = {}) {
 			await super.prepare(opts);
 			return this;
 		}
 		async save(options) {
-			if (!this._canSave || this.content === void 0) throw new require_primordials_error.ErrorCtor("No package.json to save to");
-			if (!require_json_format.shouldSave(this.content, this._readFileJson, this._readFileContent, {
+			options = {
+				__proto__: null,
+				...options
+			};
+			if (!this.canSave || this.content === void 0) throw new require_primordials_error.ErrorCtor("No package.json to save to");
+			if (!require_json_format.shouldSave(this.content, this.readFileJson, this.readFileContent, {
 				...options,
 				sortFn: options?.sort ? src_external__npmcli_package_json_lib_sort.packageSort : void 0
 			})) return false;
@@ -152,26 +156,27 @@ function getEditablePackageJsonClass() {
 			const fileContent = require_json_format.stringifyWithFormatting(options?.sort ? (0, src_external__npmcli_package_json_lib_sort.packageSort)(content) : content, require_json_format.getFormattingFromContent(this.content));
 			const { promises: fsPromises } = require_node_fs.getNodeFs();
 			await fsPromises.writeFile(this.filename, fileContent);
-			this._readFileContent = fileContent;
-			this._readFileJson = (0, src_external__npmcli_package_json_lib_read_package.parse)(fileContent);
+			this.readFileContent = fileContent;
+			this.readFileJson = (0, src_external__npmcli_package_json_lib_read_package.parse)(fileContent);
 			return true;
 		}
 		saveSync(options) {
-			if (!this._canSave || this.content === void 0) throw new require_primordials_error.ErrorCtor("No package.json to save to");
+			if (!this.canSave || this.content === void 0) throw new require_primordials_error.ErrorCtor("No package.json to save to");
 			const { ignoreWhitespace = false, sort = false } = {
 				__proto__: null,
 				...options
 			};
 			const { [Symbol.for("indent")]: indent, [Symbol.for("newline")]: newline, ...rest } = this.content;
 			const content = sort ? (0, src_external__npmcli_package_json_lib_sort.packageSort)(rest) : rest;
-			if (ignoreWhitespace && require_node_util.getNodeUtil().isDeepStrictEqual(content, this._readFileJson)) return false;
+			const util = require_node_util.getNodeUtil();
+			if (ignoreWhitespace && util.isDeepStrictEqual(content, this.readFileJson)) return false;
 			const format = indent === void 0 || indent === null ? "  " : indent;
 			const eol = newline === void 0 || newline === null ? "\n" : newline;
 			const fileContent = `${require_primordials_json.JSONStringify(content, void 0, format)}\n`.replace(/\n/g, eol);
-			if (!ignoreWhitespace && fileContent.trim() === this._readFileContent.trim()) return false;
+			if (!ignoreWhitespace && fileContent.trim() === this.readFileContent.trim()) return false;
 			require_node_fs.getNodeFs().writeFileSync(this.filename, fileContent);
-			this._readFileContent = fileContent;
-			this._readFileJson = (0, src_external__npmcli_package_json_lib_read_package.parse)(fileContent);
+			this.readFileContent = fileContent;
+			this.readFileJson = (0, src_external__npmcli_package_json_lib_read_package.parse)(fileContent);
 			return true;
 		}
 		update(content) {
@@ -183,14 +188,15 @@ function getEditablePackageJsonClass() {
 				__proto__: null,
 				...options
 			};
-			if (!this._canSave || this.content === void 0) return false;
+			if (!this.canSave || this.content === void 0) return false;
 			const { [Symbol.for("indent")]: indent, [Symbol.for("newline")]: newline, ...rest } = this.content;
 			const content = sort ? (0, src_external__npmcli_package_json_lib_sort.packageSort)(rest) : rest;
-			if (ignoreWhitespace && require_node_util.getNodeUtil().isDeepStrictEqual(content, this._readFileJson)) return false;
+			const util = require_node_util.getNodeUtil();
+			if (ignoreWhitespace && util.isDeepStrictEqual(content, this.readFileJson)) return false;
 			const format = indent === void 0 || indent === null ? "  " : indent;
 			const eol = newline === void 0 || newline === null ? "\n" : newline;
 			const fileContent = `${require_primordials_json.JSONStringify(content, void 0, format)}\n`.replace(/\n/g, eol);
-			if (!ignoreWhitespace && fileContent.trim() === this._readFileContent.trim()) return false;
+			if (!ignoreWhitespace && fileContent.trim() === this.readFileContent.trim()) return false;
 			return true;
 		}
 	};

package/dist/packages/exports.js

@@ -2,13 +2,13 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primordials_error = require('../primordials/error.js');
+const require_arrays_predicates = require('../arrays/predicates.js');
+const require_primordials_object = require('../primordials/object.js');
+const require_objects_predicates = require('../objects/predicates.js');
+const require_primordials_map_set = require('../primordials/map-set.js');
 const require_primordials_string = require('../primordials/string.js');
 const require_primordials_array = require('../primordials/array.js');
-const require_primordials_map_set = require('../primordials/map-set.js');
-const require_primordials_object = require('../primordials/object.js');
 const require_constants_sentinels = require('../constants/sentinels.js');
-const require_arrays_predicates = require('../arrays/predicates.js');
-const require_objects_predicates = require('../objects/predicates.js');
 
 //#region src/packages/exports.ts
 /**

package/dist/packages/fetch.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_objects_predicates = require('../objects/predicates.js');
-const require_constants_packages = require('../constants/packages.js');
 const require_packages_specs = require('./specs.js');
+const require_constants_packages = require('../constants/packages.js');
 const require_packages_read = require('./read.js');
 let src_external_npm_package_arg = require("../external/npm-package-arg");
 src_external_npm_package_arg = require_runtime.__toESM(src_external_npm_package_arg);

package/dist/packages/isolation.js

@@ -4,13 +4,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_primordials_error = require('../primordials/error.js');
 const require_constants_platform = require('../constants/platform.js');
+const require_primordials_object = require('../primordials/object.js');
 const require_primordials_string = require('../primordials/string.js');
 const require_paths_conversion = require('../paths/conversion.js');
 const require_paths_predicates = require('../paths/predicates.js');
 const require_node_fs = require('../node/fs.js');
 const require_node_path = require('../node/path.js');
 const require_primordials_json = require('../primordials/json.js');
-const require_primordials_object = require('../primordials/object.js');
 const require_errors_message = require('../errors/message.js');
 const require_process_spawn_child = require('../process/spawn/child.js');
 const require_paths_socket = require('../paths/socket.js');

package/dist/packages/licenses.js

@@ -3,12 +3,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_primordials_error = require('../primordials/error.js');
+const require_objects_predicates = require('../objects/predicates.js');
+const require_primordials_map_set = require('../primordials/map-set.js');
 const require_primordials_regexp = require('../primordials/regexp.js');
 const require_paths_normalize = require('../paths/normalize.js');
-const require_primordials_map_set = require('../primordials/map-set.js');
 const require_node_path = require('../node/path.js');
 const require_constants_sentinels = require('../constants/sentinels.js');
-const require_objects_predicates = require('../objects/predicates.js');
 const require_constants_licenses = require('../constants/licenses.js');
 let src_external_spdx_correct = require("../external/spdx-correct");
 src_external_spdx_correct = require_runtime.__toESM(src_external_spdx_correct);

package/dist/packages/manifest.js

@@ -2,21 +2,21 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
-const require_primordials_object = require('../primordials/object.js');
-const require_process_abort = require('../process/abort.js');
 const require_arrays_predicates = require('../arrays/predicates.js');
+const require_primordials_object = require('../primordials/object.js');
 const require_objects_predicates = require('../objects/predicates.js');
+const require_process_abort = require('../process/abort.js');
 const require_constants_socket = require('../constants/socket.js');
 const require_constants_packages = require('../constants/packages.js');
 const require_objects_sort = require('../objects/sort.js');
 const require_packages_exports = require('./exports.js');
 const require_packages_validation = require('./validation.js');
+let src_external_npm_package_arg = require("../external/npm-package-arg");
+src_external_npm_package_arg = require_runtime.__toESM(src_external_npm_package_arg);
 let src_external_semver = require("../external/semver");
 src_external_semver = require_runtime.__toESM(src_external_semver);
 let src_external_pacote = require("../external/pacote");
 src_external_pacote = require_runtime.__toESM(src_external_pacote);
-let src_external_npm_package_arg = require("../external/npm-package-arg");
-src_external_npm_package_arg = require_runtime.__toESM(src_external_npm_package_arg);
 
 //#region src/packages/manifest.ts
 /**

package/dist/packages/normalize.js

@@ -2,10 +2,10 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_object = require('../primordials/object.js');
 const require_primordials_string = require('../primordials/string.js');
 const require_primordials_regexp = require('../primordials/regexp.js');
 const require_primordials_array = require('../primordials/array.js');
-const require_primordials_object = require('../primordials/object.js');
 const require_objects_mutate = require('../objects/mutate.js');
 const require_constants_socket = require('../constants/socket.js');
 const require_regexps_escape = require('../regexps/escape.js');

package/dist/packages/provenance.js

@@ -4,11 +4,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_primordials_buffer = require('../primordials/buffer.js');
 const require_abort_signal = require('../abort/signal.js');
+const require_primordials_object = require('../primordials/object.js');
+const require_objects_predicates = require('../objects/predicates.js');
 const require_primordials_string = require('../primordials/string.js');
 const require_primordials_array = require('../primordials/array.js');
 const require_primordials_json = require('../primordials/json.js');
-const require_primordials_object = require('../primordials/object.js');
-const require_objects_predicates = require('../objects/predicates.js');
 const require_constants_agents = require('../constants/agents.js');
 const require_constants_packages = require('../constants/packages.js');
 const require_url_parse = require('../url/parse.js');

package/dist/packages/specs.js

@@ -2,9 +2,9 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_objects_predicates = require('../objects/predicates.js');
 const require_primordials_string = require('../primordials/string.js');
 const require_strings_predicates = require('../strings/predicates.js');
-const require_objects_predicates = require('../objects/predicates.js');
 const require_constants_socket = require('../constants/socket.js');
 const require_smol_purl = require('../smol/purl.js');
 let src_external__socketregistry_packageurl_js = require("../external/@socketregistry/packageurl-js");

package/dist/packages/tarball.js

@@ -2,6 +2,7 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_paths_normalize = require('../paths/normalize.js');
 const require_process_abort = require('../process/abort.js');
 const require_constants_packages = require('../constants/packages.js');
 let src_external_cacache = require("../external/cacache");
@@ -46,8 +47,9 @@ async function extractPackage(pkgNameOrId, options, callback) {
 	};
 	/* c8 ignore start - External package registry extraction */
 	if (typeof dest === "string") {
-		await src_external_pacote.default.extract(pkgNameOrId, dest, extractOptions);
-		if (typeof actualCallback === "function") await actualCallback(dest);
+		const normalizedDest = require_paths_normalize.normalizePath(dest);
+		await src_external_pacote.default.extract(pkgNameOrId, normalizedDest, extractOptions);
+		if (typeof actualCallback === "function") await actualCallback(normalizedDest);
 	} else await src_external_cacache.default.tmp.withTmp(pacoteCachePath, { tmpPrefix }, async (tmpDirPath) => {
 		await src_external_pacote.default.extract(pkgNameOrId, tmpDirPath, extractOptions);
 		if (typeof actualCallback === "function") await actualCallback(tmpDirPath);

package/dist/packages/types.d.ts

@@ -6,7 +6,7 @@
  */
 import type { CategoryString } from '../eco/types';
 import type { EditablePackageJsonInstance } from './edit';
-type PackageExports = {
+export type PackageExports = {
     [path: string]: unknown;
 };
 export type EditablePackageJson = EditablePackageJsonInstance;
@@ -131,4 +131,3 @@ export type PacoteOptions = {
     preferOffline?: boolean | undefined;
     fullMetadata?: boolean | undefined;
 };
-export {};

package/dist/paths/dirnames.d.ts

@@ -7,5 +7,6 @@ export declare const DOT_GITHUB = ".github";
 export declare const DOT_SOCKET_DIR = ".socket";
 export declare const CACHE_DIR = "cache";
 export declare const CACHE_TTL_DIR = "ttl";
+export declare const RUN_DIR = "run";
 export declare const NODE_MODULES_GLOB_RECURSIVE = "**/node_modules";
 export declare const SLASH_NODE_MODULES_SLASH = "/node_modules/";

package/dist/paths/dirnames.js

@@ -12,6 +12,7 @@ const DOT_GITHUB = ".github";
 const DOT_SOCKET_DIR = ".socket";
 const CACHE_DIR = "cache";
 const CACHE_TTL_DIR = "ttl";
+const RUN_DIR = "run";
 const NODE_MODULES_GLOB_RECURSIVE = "**/node_modules";
 const SLASH_NODE_MODULES_SLASH = "/node_modules/";
 
@@ -23,4 +24,5 @@ exports.DOT_GIT_DIR = DOT_GIT_DIR;
 exports.DOT_SOCKET_DIR = DOT_SOCKET_DIR;
 exports.NODE_MODULES = NODE_MODULES;
 exports.NODE_MODULES_GLOB_RECURSIVE = NODE_MODULES_GLOB_RECURSIVE;
+exports.RUN_DIR = RUN_DIR;
 exports.SLASH_NODE_MODULES_SLASH = SLASH_NODE_MODULES_SLASH;

package/dist/paths/resolve.js

@@ -1,11 +1,6 @@
 "use strict";
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_constants_platform = require('../constants/platform.js');
-const require_primordials_string = require('../primordials/string.js');
-const require_paths__internal = require('./_internal.js');
-const require_paths_predicates = require('./predicates.js');
-const require_paths_normalize = require('./normalize.js');
 
 //#region src/paths/resolve.ts
 /**
@@ -44,7 +39,7 @@ function relative(from, to) {
 	const actualTo = resolve(to);
 	if (actualFrom === actualTo) return "";
 	/* c8 ignore start - Windows-only case-insensitive comparison. */
-	if (require_constants_platform.WIN32) {
+	if (WIN32) {
 		if (actualFrom.toLowerCase() === actualTo.toLowerCase()) return "";
 	}
 	/* c8 ignore stop */
@@ -57,32 +52,32 @@ function relative(from, to) {
 	let lastCommonSep = -1;
 	let i = 0;
 	for (; i < length; i += 1) {
-		let fromCode = require_primordials_string.StringPrototypeCharCodeAt(actualFrom, fromStart + i);
-		let toCode = require_primordials_string.StringPrototypeCharCodeAt(actualTo, toStart + i);
+		let fromCode = StringPrototypeCharCodeAt(actualFrom, fromStart + i);
+		let toCode = StringPrototypeCharCodeAt(actualTo, toStart + i);
 		/* c8 ignore start - Windows-only case folding. */
-		if (require_constants_platform.WIN32) {
-			if (fromCode >= 65 && fromCode <= 90) fromCode += 32;
-			if (toCode >= 65 && toCode <= 90) toCode += 32;
+		if (WIN32) {
+			if (fromCode >= CHAR_UPPERCASE_A && fromCode <= CHAR_UPPERCASE_Z) fromCode += 32;
+			if (toCode >= CHAR_UPPERCASE_A && toCode <= CHAR_UPPERCASE_Z) toCode += 32;
 		}
 		/* c8 ignore stop */
 		if (fromCode !== toCode) break;
-		if (require_paths_predicates.isPathSeparator(require_primordials_string.StringPrototypeCharCodeAt(actualFrom, fromStart + i))) lastCommonSep = i;
+		if (isPathSeparator(StringPrototypeCharCodeAt(actualFrom, fromStart + i))) lastCommonSep = i;
 	}
 	/* c8 ignore start */
 	if (i === length) {
 		if (toLen > length) {
-			if (require_paths_predicates.isPathSeparator(require_primordials_string.StringPrototypeCharCodeAt(actualTo, toStart + i))) return actualTo.slice(toStart + i + 1);
+			if (isPathSeparator(StringPrototypeCharCodeAt(actualTo, toStart + i))) return actualTo.slice(toStart + i + 1);
 			if (i === 0) return actualTo.slice(toStart + i);
 		} else if (fromLen > length) {
-			if (require_paths_predicates.isPathSeparator(require_primordials_string.StringPrototypeCharCodeAt(actualFrom, fromStart + i))) lastCommonSep = i;
+			if (isPathSeparator(StringPrototypeCharCodeAt(actualFrom, fromStart + i))) lastCommonSep = i;
 			else if (i === 0) lastCommonSep = 0;
 		}
 	}
 	/* c8 ignore stop */
 	let out = "";
 	for (i = fromStart + lastCommonSep + 1; i <= fromEnd; i += 1) {
-		const code = require_primordials_string.StringPrototypeCharCodeAt(actualFrom, i);
-		if (i === fromEnd || require_paths_predicates.isPathSeparator(code)) out += out.length === 0 ? ".." : "/..";
+		const code = StringPrototypeCharCodeAt(actualFrom, i);
+		if (i === fromEnd || isPathSeparator(code)) out += out.length === 0 ? ".." : "/..";
 	}
 	return out + actualTo.slice(toStart + lastCommonSep);
 }
@@ -108,7 +103,7 @@ function relative(from, to) {
 function relativeResolve(from, to) {
 	const rel = relative(from, to);
 	if (rel === "") return "";
-	return require_paths_normalize.normalizePath(rel);
+	return normalizePath(rel);
 }
 /**
 * Resolve an absolute path from path segments.
@@ -137,11 +132,11 @@ function resolve(...segments) {
 		/* c8 ignore start */
 		if (typeof segment !== "string" || segment.length === 0) continue;
 		resolvedPath = segment + (resolvedPath.length === 0 ? "" : `/${resolvedPath}`);
-		resolvedAbsolute = require_paths_predicates.isAbsolute(segment);
+		resolvedAbsolute = isAbsolute(segment);
 	}
 	if (!resolvedAbsolute) resolvedPath = /* @__PURE__ */ require("node:process").cwd() + (resolvedPath.length === 0 ? "" : `/${resolvedPath}`);
 	/* c8 ignore stop */
-	return require_paths_normalize.normalizePath(resolvedPath);
+	return normalizePath(resolvedPath);
 }
 
 //#endregion

package/dist/paths/rewire.d.ts

@@ -7,6 +7,11 @@
  *   - Automatic cache invalidation for path-dependent modules
  *   - Thread-safe for concurrent test execution
  */
+export interface PathRewireState {
+    testOverrides: Map<string, string | undefined>;
+    valueCache: Map<string, string>;
+    cacheInvalidationCallbacks: Array<() => void>;
+}
 /**
  * Clear a specific path override.
  */