@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/env/node-auth-token.js

@@ -1,34 +1,31 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var node_auth_token_exports = {};
-__export(node_auth_token_exports, {
-  getNodeAuthToken: () => getNodeAuthToken
-});
-module.exports = __toCommonJS(node_auth_token_exports);
-var import_rewire = require("./rewire");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_env_rewire = require('./rewire.js');
+
+//#region src/env/node-auth-token.ts
+/**
+* @file NODE_AUTH_TOKEN environment variable getter. Exports
+*   `getNodeAuthToken()`, returning the value of `NODE_AUTH_TOKEN` used to
+*   authenticate against Node.js package registries.
+*/
+/**
+* Returns the value of the NODE_AUTH_TOKEN environment variable.
+*
+* @example
+*   ;```typescript
+*   import { getNodeAuthToken } from '@socketsecurity/lib/env/node-auth-token'
+*
+*   const token = getNodeAuthToken()
+*   // e.g. 'npm_abc123...' or undefined
+*   ```
+*
+* @returns The Node.js registry auth token, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getNodeAuthToken() {
-  return (0, import_rewire.getEnvValue)("NODE_AUTH_TOKEN");
+	return require_env_rewire.getEnvValue("NODE_AUTH_TOKEN");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getNodeAuthToken
-});
+
+//#endregion
+exports.getNodeAuthToken = getNodeAuthToken;

package/dist/env/node-env.js

@@ -1,34 +1,31 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var node_env_exports = {};
-__export(node_env_exports, {
-  getNodeEnv: () => getNodeEnv
-});
-module.exports = __toCommonJS(node_env_exports);
-var import_rewire = require("./rewire");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_env_rewire = require('./rewire.js');
+
+//#region src/env/node-env.ts
+/**
+* @file NODE_ENV environment variable getter. Exports `getNodeEnv()`, returning
+*   the raw `NODE_ENV` value (typically 'production', 'development', or 'test')
+*   or `undefined` when unset.
+*/
+/**
+* Returns the value of the NODE_ENV environment variable.
+*
+* @example
+*   ;```typescript
+*   import { getNodeEnv } from '@socketsecurity/lib/env/node-env'
+*
+*   const env = getNodeEnv()
+*   // e.g. 'production', 'development', 'test', or undefined
+*   ```
+*
+* @returns The Node.js environment mode, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getNodeEnv() {
-  return (0, import_rewire.getEnvValue)("NODE_ENV");
+	return require_env_rewire.getEnvValue("NODE_ENV");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getNodeEnv
-});
+
+//#endregion
+exports.getNodeEnv = getNodeEnv;

package/dist/env/npm.js

@@ -1,58 +1,105 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var npm_exports = {};
-__export(npm_exports, {
-  getNpmConfigRegistry: () => getNpmConfigRegistry,
-  getNpmConfigUserAgent: () => getNpmConfigUserAgent,
-  getNpmLifecycleEvent: () => getNpmLifecycleEvent,
-  getNpmRegistry: () => getNpmRegistry,
-  getNpmToken: () => getNpmToken
-});
-module.exports = __toCommonJS(npm_exports);
-var import_rewire = require("./rewire");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_env_rewire = require('./rewire.js');
+
+//#region src/env/npm.ts
+/**
+* @file NPM environment variable getters. Provides access to NPM and package
+*   manager environment variables.
+*/
+/**
+* Npm_config_registry environment variable. NPM registry URL configured by
+* package managers.
+*
+* @example
+*   ;```typescript
+*   import { getNpmConfigRegistry } from '@socketsecurity/lib/env/npm'
+*
+*   const registry = getNpmConfigRegistry()
+*   // e.g. 'https://registry.npmjs.org/' or undefined
+*   ```
+*
+* @returns The configured NPM registry URL, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getNpmConfigRegistry() {
-  return (0, import_rewire.getEnvValue)("npm_config_registry");
+	return require_env_rewire.getEnvValue("npm_config_registry");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Npm_config_user_agent environment variable. User agent string set by
+* npm/pnpm/yarn package managers.
+*
+* @example
+*   ;```typescript
+*   import { getNpmConfigUserAgent } from '@socketsecurity/lib/env/npm'
+*
+*   const ua = getNpmConfigUserAgent()
+*   // e.g. 'pnpm/9.0.0 npm/? node/v20.0.0 darwin arm64'
+*   ```
+*
+* @returns The package manager user agent string, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getNpmConfigUserAgent() {
-  return (0, import_rewire.getEnvValue)("npm_config_user_agent");
+	return require_env_rewire.getEnvValue("npm_config_user_agent");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Npm_lifecycle_event environment variable. The name of the npm lifecycle event
+* that's currently running.
+*
+* @example
+*   ;```typescript
+*   import { getNpmLifecycleEvent } from '@socketsecurity/lib/env/npm'
+*
+*   const event = getNpmLifecycleEvent()
+*   // e.g. 'install', 'postinstall', or 'test'
+*   ```
+*
+* @returns The current lifecycle event name, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getNpmLifecycleEvent() {
-  return (0, import_rewire.getEnvValue)("npm_lifecycle_event");
+	return require_env_rewire.getEnvValue("npm_lifecycle_event");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* NPM_REGISTRY environment variable. NPM registry URL override.
+*
+* @example
+*   ;```typescript
+*   import { getNpmRegistry } from '@socketsecurity/lib/env/npm'
+*
+*   const registry = getNpmRegistry()
+*   // e.g. 'https://registry.npmjs.org/' or undefined
+*   ```
+*
+* @returns The NPM registry URL override, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getNpmRegistry() {
-  return (0, import_rewire.getEnvValue)("NPM_REGISTRY");
+	return require_env_rewire.getEnvValue("NPM_REGISTRY");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* NPM_TOKEN environment variable. Authentication token for NPM registry access.
+*
+* @example
+*   ;```typescript
+*   import { getNpmToken } from '@socketsecurity/lib/env/npm'
+*
+*   const token = getNpmToken()
+*   // e.g. 'npm_abc123...' or undefined
+*   ```
+*
+* @returns The NPM auth token, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getNpmToken() {
-  return (0, import_rewire.getEnvValue)("NPM_TOKEN");
+	return require_env_rewire.getEnvValue("NPM_TOKEN");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getNpmConfigRegistry,
-  getNpmConfigUserAgent,
-  getNpmLifecycleEvent,
-  getNpmRegistry,
-  getNpmToken
-});
+
+//#endregion
+exports.getNpmConfigRegistry = getNpmConfigRegistry;
+exports.getNpmConfigUserAgent = getNpmConfigUserAgent;
+exports.getNpmLifecycleEvent = getNpmLifecycleEvent;
+exports.getNpmRegistry = getNpmRegistry;
+exports.getNpmToken = getNpmToken;

package/dist/env/number.js

@@ -1,54 +1,53 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var number_exports = {};
-__export(number_exports, {
-  envAsNumber: () => envAsNumber
-});
-module.exports = __toCommonJS(number_exports);
-var import_number = require("../primordials/number");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_number = require('../primordials/number.js');
+
+//#region src/env/number.ts
+/**
+* @file `envAsNumber` — coerce an env-var-shaped value into a number. `mode:
+*   'int'` uses `parseInt(_, 10)`; `mode: 'float'` uses `Number()`. Non-finite
+*   results round-trip through `defaultValue` unless `allowInfinity: true` is
+*   set.
+*/
+/**
+* Convert an environment variable value to a number.
+*
+* Back-compat overload: passing a bare number as the second argument is
+* equivalent to `{ defaultValue: N }`.
+*
+* @example
+*   ;```typescript
+*   import { envAsNumber } from '@socketsecurity/lib/env/number'
+*
+*   envAsNumber('3000') // 3000 (int mode)
+*   envAsNumber('3.14', { mode: 'float' }) // 3.14
+*   envAsNumber('abc') // 0
+*   envAsNumber(undefined, 42) // 42 (legacy positional default)
+*   ```
+*
+* @param value - The value to convert.
+* @param defaultValueOrOptions - Default (number) or options object.
+*
+* @returns The parsed number, or the default value if parsing fails
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function envAsNumber(value, defaultValueOrOptions = 0) {
-  const opts = typeof defaultValueOrOptions === "number" ? { defaultValue: defaultValueOrOptions } : defaultValueOrOptions ?? {};
-  const { allowInfinity = false, defaultValue = 0, mode = "int" } = opts;
-  if (value === void 0 || value === null) {
-    return defaultValue;
-  }
-  if (typeof value === "string") {
-    if (!value) {
-      return defaultValue;
-    }
-    const num = mode === "float" ? (0, import_number.NumberCtor)(value) : (0, import_number.NumberParseInt)(value, 10);
-    if ((0, import_number.NumberIsNaN)(num)) {
-      return defaultValue;
-    }
-    if (!(0, import_number.NumberIsFinite)(num)) {
-      return allowInfinity ? num : defaultValue;
-    }
-    return num || 0;
-  }
-  const numOrNaN = mode === "float" ? (0, import_number.NumberCtor)(String(value)) : (0, import_number.NumberParseInt)(String(value), 10);
-  const numMayBeNegZero = (0, import_number.NumberIsFinite)(numOrNaN) ? numOrNaN : (0, import_number.NumberCtor)(defaultValue);
-  return numMayBeNegZero || 0;
+	const { allowInfinity = false, defaultValue = 0, mode = "int" } = typeof defaultValueOrOptions === "number" ? { defaultValue: defaultValueOrOptions } : defaultValueOrOptions ?? {};
+	if (value === void 0 || value === null) return defaultValue;
+	if (typeof value === "string") {
+		if (!value) return defaultValue;
+		/* c8 ignore start */
+		const num = mode === "float" ? require_primordials_number.NumberCtor(value) : require_primordials_number.NumberParseInt(value, 10);
+		if (require_primordials_number.NumberIsNaN(num)) return defaultValue;
+		if (!require_primordials_number.NumberIsFinite(num)) return allowInfinity ? num : defaultValue;
+		return num || 0;
+	}
+	/* c8 ignore start */
+	const numOrNaN = mode === "float" ? require_primordials_number.NumberCtor(String(value)) : require_primordials_number.NumberParseInt(String(value), 10);
+	return (require_primordials_number.NumberIsFinite(numOrNaN) ? numOrNaN : require_primordials_number.NumberCtor(defaultValue)) || 0;
+	/* c8 ignore stop */
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  envAsNumber
-});
+
+//#endregion
+exports.envAsNumber = envAsNumber;

package/dist/env/package-manager.js

@@ -1,90 +1,102 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var package_manager_exports = {};
-__export(package_manager_exports, {
-  detectPackageManager: () => detectPackageManager,
-  getPackageManagerInfo: () => getPackageManagerInfo,
-  getPackageManagerUserAgent: () => getPackageManagerUserAgent
-});
-module.exports = __toCommonJS(package_manager_exports);
-var import_node_process = __toESM(require("node:process"));
-var import_rewire = require("./rewire");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_env_rewire = require('./rewire.js');
+let node_process = require("node:process");
+node_process = require_runtime.__toESM(node_process);
+
+//#region src/env/package-manager.ts
+/**
+* @file Package manager environment detection. Provides utilities to detect
+*   which package manager (npm/pnpm/yarn/bun) is running.
+*/
+/**
+* Detect which package manager is currently running based on environment
+* variables. Checks npm_config_user_agent which all package managers set.
+*
+* Detection priority:
+*
+* 1. Npm_config_user_agent (most reliable, set by all package managers)
+* 2. Binary path analysis (fallback for non-standard environments)
+*
+* @example
+*   ;```typescript
+*   // During: npm install
+*   detectPackageManager() // 'npm'
+*
+*   // During: pnpm install
+*   detectPackageManager() // 'pnpm'
+*
+*   // During: yarn install
+*   detectPackageManager() // 'yarn'
+*
+*   // Outside package manager context
+*   detectPackageManager() // undefined
+*   ```
+*
+* @returns The detected package manager or null if unable to determine
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function detectPackageManager() {
-  const userAgent = /* @__PURE__ */ getPackageManagerUserAgent();
-  if (userAgent) {
-    const match = userAgent.match(/^(npm|pnpm|yarn|bun)\//);
-    if (match) {
-      return match[1];
-    }
-  }
-  const argv0 = import_node_process.default.argv[0];
-  if (argv0) {
-    if (argv0.includes("/pnpm/") || argv0.includes("\\pnpm\\")) {
-      return "pnpm";
-    }
-    if (argv0.includes("/yarn/") || argv0.includes("\\yarn\\") || argv0.includes("/.yarn/") || argv0.includes("\\.yarn\\")) {
-      return "yarn";
-    }
-    if (argv0.includes("/bun/") || argv0.includes("\\bun\\")) {
-      return "bun";
-    }
-    if (argv0.includes("/node_modules/") || argv0.includes("\\node_modules\\")) {
-      return "npm";
-    }
-  }
-  return void 0;
+	const userAgent = /* @__PURE__ */ getPackageManagerUserAgent();
+	if (userAgent) {
+		const match = userAgent.match(/^(npm|pnpm|yarn|bun)\//);
+		if (match) return match[1];
+	}
+	/* c8 ignore start - argv0-based PM fallback only fires when
+	npm_config_user_agent / lifecycle env detection both miss.
+	In test runs argv0 is always the test runner's node binary,
+	not a PM shim. */
+	const argv0 = node_process.default.argv[0];
+	if (argv0) {
+		if (argv0.includes("/pnpm/") || argv0.includes("\\pnpm\\")) return "pnpm";
+		if (argv0.includes("/yarn/") || argv0.includes("\\yarn\\") || argv0.includes("/.yarn/") || argv0.includes("\\.yarn\\")) return "yarn";
+		if (argv0.includes("/bun/") || argv0.includes("\\bun\\")) return "bun";
+		if (argv0.includes("/node_modules/") || argv0.includes("\\node_modules\\")) return "npm";
+	}
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Get the package manager name and version from user agent.
+*
+* @example
+*   ;```typescript
+*   getPackageManagerInfo()
+*   // { name: 'pnpm', version: '8.15.1' }
+*   ```
+*
+* @returns Object with name and version, or null if not available
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getPackageManagerInfo() {
-  const userAgent = /* @__PURE__ */ getPackageManagerUserAgent();
-  if (!userAgent) {
-    return void 0;
-  }
-  const match = userAgent.match(/^([^/]+)\/([^\s]+)/);
-  if (match?.[1] && match[2]) {
-    return {
-      name: match[1],
-      version: match[2]
-    };
-  }
-  return void 0;
+	const userAgent = /* @__PURE__ */ getPackageManagerUserAgent();
+	if (!userAgent) return;
+	const match = userAgent.match(/^([^/]+)\/([^\s]+)/);
+	if (match?.[1] && match[2]) return {
+		name: match[1],
+		version: match[2]
+	};
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Get the package manager user agent from environment. Package managers set
+* npm_config_user_agent with format: "npm/8.19.2 node/v18.12.0 darwin arm64"
+*
+* @example
+*   ;```typescript
+*   getPackageManagerUserAgent()
+*   // npm: "npm/10.2.4 node/v20.11.0 darwin arm64 workspaces/false"
+*   // pnpm: "pnpm/8.15.1 npm/? node/v20.11.0 darwin arm64"
+*   // yarn: "yarn/1.22.19 npm/? node/v20.11.0 darwin arm64"
+*   ```
+*
+* @returns The user agent string or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getPackageManagerUserAgent() {
-  return (0, import_rewire.getEnvValue)("npm_config_user_agent");
+	return require_env_rewire.getEnvValue("npm_config_user_agent");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  detectPackageManager,
-  getPackageManagerInfo,
-  getPackageManagerUserAgent
-});
+
+//#endregion
+exports.detectPackageManager = detectPackageManager;
+exports.getPackageManagerInfo = getPackageManagerInfo;
+exports.getPackageManagerUserAgent = getPackageManagerUserAgent;

package/dist/env/path.js

@@ -1,34 +1,31 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var path_exports = {};
-__export(path_exports, {
-  getPath: () => getPath
-});
-module.exports = __toCommonJS(path_exports);
-var import_rewire = require("./rewire");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_env_rewire = require('./rewire.js');
+
+//#region src/env/path.ts
+/**
+* @file PATH environment variable getter. Exports `getPath()`, returning the
+*   raw value of the `PATH` environment variable that lists executable search
+*   directories.
+*/
+/**
+* Returns the value of the PATH environment variable.
+*
+* @example
+*   ;```typescript
+*   import { getPath } from '@socketsecurity/lib/env/path'
+*
+*   const path = getPath()
+*   // e.g. '/usr/local/bin:/usr/bin:/bin' or undefined
+*   ```
+*
+* @returns The system executable search paths, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getPath() {
-  return (0, import_rewire.getEnvValue)("PATH");
+	return require_env_rewire.getEnvValue("PATH");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getPath
-});
+
+//#endregion
+exports.getPath = getPath;