@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/env/string.js

@@ -1,47 +1,46 @@
 "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 string_exports = {};
-__export(string_exports, {
-  envAsString: () => envAsString
-});
-module.exports = __toCommonJS(string_exports);
-var import_array = require("../primordials/array");
-var import_string = require("../primordials/string");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+const require_primordials_array = require('../primordials/array.js');
+
+//#region src/env/string.ts
+/**
+* @file `envAsString` — coerce an env-var-shaped value into a string. Defaults
+*   to trimming whitespace; `trim: false` preserves the value as-is. Positional
+*   second argument is back-compat for the legacy `defaultValue` form.
+*/
+/**
+* Convert an environment variable value to a string.
+*
+* Back-compat overload: passing a bare string as the second argument is
+* equivalent to `{ defaultValue: S }`.
+*
+* @example
+*   ;```typescript
+*   import { envAsString } from '@socketsecurity/lib/env/string'
+*
+*   envAsString('  hello  ') // 'hello' (trimmed)
+*   envAsString('  hello  ', { trim: false }) // '  hello  '
+*   envAsString(undefined) // ''
+*   envAsString(null, 'n/a') // 'n/a' (legacy positional)
+*   ```
+*
+* @param value - The value to convert.
+* @param defaultValueOrOptions - Default (string) or options object.
+*
+* @returns The string value, or the default value
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function envAsString(value, defaultValueOrOptions = "") {
-  const isOptionsObject = typeof defaultValueOrOptions === "object" && defaultValueOrOptions !== null && !(0, import_array.ArrayIsArray)(defaultValueOrOptions) && ("defaultValue" in defaultValueOrOptions || "trim" in defaultValueOrOptions);
-  const opts = isOptionsObject ? defaultValueOrOptions : {
-    defaultValue: defaultValueOrOptions === void 0 ? "" : typeof defaultValueOrOptions === "string" ? defaultValueOrOptions : (0, import_string.StringCtor)(defaultValueOrOptions)
-  };
-  const { defaultValue = "", trim = true } = opts;
-  if (value === void 0 || value === null) {
-    return defaultValue === "" || !trim ? defaultValue : (0, import_string.StringCtor)(defaultValue).trim();
-  }
-  if (typeof value === "string") {
-    return trim ? value.trim() : value;
-  }
-  const str = (0, import_string.StringCtor)(value);
-  return trim ? str.trim() : str;
+	/* c8 ignore stop */
+	const { defaultValue = "", trim = true } = typeof defaultValueOrOptions === "object" && defaultValueOrOptions !== null && !require_primordials_array.ArrayIsArray(defaultValueOrOptions) && ("defaultValue" in defaultValueOrOptions || "trim" in defaultValueOrOptions) ? defaultValueOrOptions : { defaultValue: defaultValueOrOptions === void 0 ? "" : typeof defaultValueOrOptions === "string" ? defaultValueOrOptions : require_primordials_string.StringCtor(defaultValueOrOptions) };
+	if (value === void 0 || value === null) return defaultValue === "" || !trim ? defaultValue : require_primordials_string.StringCtor(defaultValue).trim();
+	if (typeof value === "string") return trim ? value.trim() : value;
+	/* c8 ignore next 2 */
+	const str = require_primordials_string.StringCtor(value);
+	return trim ? str.trim() : str;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  envAsString
-});
+
+//#endregion
+exports.envAsString = envAsString;

package/dist/env/temp-dir.js

@@ -1,46 +1,66 @@
 "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 temp_dir_exports = {};
-__export(temp_dir_exports, {
-  getTemp: () => getTemp,
-  getTmp: () => getTmp,
-  getTmpdir: () => getTmpdir
-});
-module.exports = __toCommonJS(temp_dir_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/temp-dir.ts
+/**
+* @file Temporary directory environment variable getters. Different platforms
+*   use different environment variables for temp directories.
+*/
+/**
+* TEMP environment variable. Windows temporary directory path.
+*
+* @example
+*   ;```typescript
+*   import { getTemp } from '@socketsecurity/lib/env/temp-dir'
+*
+*   const temp = getTemp()
+*   // e.g. 'C:\\Windows\\Temp' or undefined
+*   ```
+*
+* @returns The Windows temp directory path, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getTemp() {
-  return (0, import_rewire.getEnvValue)("TEMP");
+	return require_env_rewire.getEnvValue("TEMP");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* TMP environment variable. Alternative temporary directory path.
+*
+* @example
+*   ;```typescript
+*   import { getTmp } from '@socketsecurity/lib/env/temp-dir'
+*
+*   const tmp = getTmp()
+*   // e.g. '/tmp' or undefined
+*   ```
+*
+* @returns The alternative temp directory path, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getTmp() {
-  return (0, import_rewire.getEnvValue)("TMP");
+	return require_env_rewire.getEnvValue("TMP");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* TMPDIR environment variable. Unix/macOS temporary directory path.
+*
+* @example
+*   ;```typescript
+*   import { getTmpdir } from '@socketsecurity/lib/env/temp-dir'
+*
+*   const tmpdir = getTmpdir()
+*   // e.g. '/tmp' or undefined
+*   ```
+*
+* @returns The Unix/macOS temp directory path, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getTmpdir() {
-  return (0, import_rewire.getEnvValue)("TMPDIR");
+	return require_env_rewire.getEnvValue("TMPDIR");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getTemp,
-  getTmp,
-  getTmpdir
-});
+
+//#endregion
+exports.getTemp = getTemp;
+exports.getTmp = getTmp;
+exports.getTmpdir = getTmpdir;

package/dist/env/term.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 term_exports = {};
-__export(term_exports, {
-  getTerm: () => getTerm
-});
-module.exports = __toCommonJS(term_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/term.ts
+/**
+* @file TERM environment variable getter. Exports `getTerm()`, returning the
+*   `TERM` terminal type identifier (for example `xterm-256color`) or
+*   `undefined` when unset.
+*/
+/**
+* Returns the value of the TERM environment variable.
+*
+* @example
+*   ;```typescript
+*   import { getTerm } from '@socketsecurity/lib/env/term'
+*
+*   const term = getTerm()
+*   // e.g. 'xterm-256color' or undefined
+*   ```
+*
+* @returns The terminal type identifier, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getTerm() {
-  return (0, import_rewire.getEnvValue)("TERM");
+	return require_env_rewire.getEnvValue("TERM");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getTerm
-});
+
+//#endregion
+exports.getTerm = getTerm;

package/dist/env/test.js

@@ -1,50 +1,72 @@
 "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 test_exports = {};
-__export(test_exports, {
-  getJestWorkerId: () => getJestWorkerId,
-  getVitest: () => getVitest,
-  isTest: () => isTest
-});
-module.exports = __toCommonJS(test_exports);
-var import_boolean = require("./boolean");
-var import_string = require("./string");
-var import_node_env = require("./node-env");
-var import_rewire = require("./rewire");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_env_boolean = require('./boolean.js');
+const require_env_rewire = require('./rewire.js');
+const require_env_node_env = require('./node-env.js');
+const require_env_string = require('./string.js');
+
+//#region src/env/test.ts
+/**
+* @file Test environment variable getters and detection. Provides access to
+*   test framework environment variables and utilities.
+*/
+/**
+* JEST_WORKER_ID environment variable. Set when running tests with Jest.
+*
+* @example
+*   ;```typescript
+*   import { getJestWorkerId } from '@socketsecurity/lib/env/test'
+*
+*   const workerId = getJestWorkerId()
+*   // e.g. '1' when running in Jest, or ''
+*   ```
+*
+* @returns The Jest worker ID string, or empty string if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getJestWorkerId() {
-  return (0, import_string.envAsString)((0, import_rewire.getEnvValue)("JEST_WORKER_ID"));
+	return /* @__PURE__ */ require_env_string.envAsString(require_env_rewire.getEnvValue("JEST_WORKER_ID"));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* VITEST environment variable. Set when running tests with Vitest.
+*
+* @example
+*   ;```typescript
+*   import { getVitest } from '@socketsecurity/lib/env/test'
+*
+*   if (getVitest()) {
+*     console.log('Running in Vitest')
+*   }
+*   ```
+*
+* @returns `true` if running in Vitest, `false` otherwise
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getVitest() {
-  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("VITEST"));
+	return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("VITEST"));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Check if code is running in a test environment. Checks NODE_ENV, VITEST, and
+* JEST_WORKER_ID.
+*
+* @example
+*   ;```typescript
+*   import { isTest } from '@socketsecurity/lib/env/test'
+*
+*   if (isTest()) {
+*     console.log('Running in test environment')
+*   }
+*   ```
+*
+* @returns `true` if running in a test environment, `false` otherwise
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function isTest() {
-  const nodeEnv = (0, import_string.envAsString)((0, import_node_env.getNodeEnv)());
-  return nodeEnv === "test" || /* @__PURE__ */ getVitest() || !!/* @__PURE__ */ getJestWorkerId();
+	return /* @__PURE__ */ require_env_string.envAsString(/* @__PURE__ */ require_env_node_env.getNodeEnv()) === "test" || /* @__PURE__ */ getVitest() || !!/* @__PURE__ */ getJestWorkerId();
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getJestWorkerId,
-  getVitest,
-  isTest
-});
+
+//#endregion
+exports.getJestWorkerId = getJestWorkerId;
+exports.getVitest = getVitest;
+exports.isTest = isTest;

package/dist/env/types.js

@@ -1,18 +1,2 @@
 "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 __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 types_exports = {};
-module.exports = __toCommonJS(types_exports);
+/* Socket Lib - Built with rolldown */

package/dist/env/windows.js

@@ -1,52 +1,87 @@
 "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 windows_exports = {};
-__export(windows_exports, {
-  getAppdata: () => getAppdata,
-  getComspec: () => getComspec,
-  getLocalappdata: () => getLocalappdata,
-  getUserprofile: () => getUserprofile
-});
-module.exports = __toCommonJS(windows_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/windows.ts
+/**
+* @file Windows environment variable getters. Provides access to
+*   Windows-specific user directory paths.
+*/
+/**
+* APPDATA environment variable. Points to the Application Data directory on
+* Windows.
+*
+* @example
+*   ;```typescript
+*   import { getAppdata } from '@socketsecurity/lib/env/windows'
+*
+*   const appdata = getAppdata()
+*   // e.g. 'C:\\Users\\Public\\AppData\\Roaming' or undefined
+*   ```
+*
+* @returns The Windows AppData roaming directory, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getAppdata() {
-  return (0, import_rewire.getEnvValue)("APPDATA");
+	return require_env_rewire.getEnvValue("APPDATA");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* COMSPEC environment variable. Points to the Windows command processor
+* (typically cmd.exe).
+*
+* @example
+*   ;```typescript
+*   import { getComspec } from '@socketsecurity/lib/env/windows'
+*
+*   const comspec = getComspec()
+*   // e.g. 'C:\\Windows\\system32\\cmd.exe' or undefined
+*   ```
+*
+* @returns The path to the command processor, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getComspec() {
-  return (0, import_rewire.getEnvValue)("COMSPEC");
+	return require_env_rewire.getEnvValue("COMSPEC");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* LOCALAPPDATA environment variable. Points to the Local Application Data
+* directory on Windows.
+*
+* @example
+*   ;```typescript
+*   import { getLocalappdata } from '@socketsecurity/lib/env/windows'
+*
+*   const localAppdata = getLocalappdata()
+*   // e.g. 'C:\\Users\\Public\\AppData\\Local' or undefined
+*   ```
+*
+* @returns The Windows local AppData directory, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getLocalappdata() {
-  return (0, import_rewire.getEnvValue)("LOCALAPPDATA");
+	return require_env_rewire.getEnvValue("LOCALAPPDATA");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* USERPROFILE environment variable. Windows user home directory path.
+*
+* @example
+*   ;```typescript
+*   import { getUserprofile } from '@socketsecurity/lib/env/windows'
+*
+*   const userprofile = getUserprofile()
+*   // e.g. 'C:\\Users\\Public' or undefined
+*   ```
+*
+* @returns The Windows user profile directory, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getUserprofile() {
-  return (0, import_rewire.getEnvValue)("USERPROFILE");
+	return require_env_rewire.getEnvValue("USERPROFILE");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getAppdata,
-  getComspec,
-  getLocalappdata,
-  getUserprofile
-});
+
+//#endregion
+exports.getAppdata = getAppdata;
+exports.getComspec = getComspec;
+exports.getLocalappdata = getLocalappdata;
+exports.getUserprofile = getUserprofile;

package/dist/env/xdg.js

@@ -1,46 +1,69 @@
 "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 xdg_exports = {};
-__export(xdg_exports, {
-  getXdgCacheHome: () => getXdgCacheHome,
-  getXdgConfigHome: () => getXdgConfigHome,
-  getXdgDataHome: () => getXdgDataHome
-});
-module.exports = __toCommonJS(xdg_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/xdg.ts
+/**
+* @file XDG Base Directory Specification environment variable getters. Provides
+*   access to XDG user directories on Unix systems.
+*/
+/**
+* XDG_CACHE_HOME environment variable. XDG Base Directory specification cache
+* directory.
+*
+* @example
+*   ;```typescript
+*   import { getXdgCacheHome } from '@socketsecurity/lib/env/xdg'
+*
+*   const cacheDir = getXdgCacheHome()
+*   // e.g. '/tmp/.cache' or undefined
+*   ```
+*
+* @returns The XDG cache directory path, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getXdgCacheHome() {
-  return (0, import_rewire.getEnvValue)("XDG_CACHE_HOME");
+	return require_env_rewire.getEnvValue("XDG_CACHE_HOME");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* XDG_CONFIG_HOME environment variable. XDG Base Directory specification config
+* directory.
+*
+* @example
+*   ;```typescript
+*   import { getXdgConfigHome } from '@socketsecurity/lib/env/xdg'
+*
+*   const configDir = getXdgConfigHome()
+*   // e.g. '/tmp/.config' or undefined
+*   ```
+*
+* @returns The XDG config directory path, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getXdgConfigHome() {
-  return (0, import_rewire.getEnvValue)("XDG_CONFIG_HOME");
+	return require_env_rewire.getEnvValue("XDG_CONFIG_HOME");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* XDG_DATA_HOME environment variable. Points to the user's data directory on
+* Unix systems.
+*
+* @example
+*   ;```typescript
+*   import { getXdgDataHome } from '@socketsecurity/lib/env/xdg'
+*
+*   const dataDir = getXdgDataHome()
+*   // e.g. '/tmp/.local/share' or undefined
+*   ```
+*
+* @returns The XDG data directory path, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getXdgDataHome() {
-  return (0, import_rewire.getEnvValue)("XDG_DATA_HOME");
+	return require_env_rewire.getEnvValue("XDG_DATA_HOME");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getXdgCacheHome,
-  getXdgConfigHome,
-  getXdgDataHome
-});
+
+//#endregion
+exports.getXdgCacheHome = getXdgCacheHome;
+exports.getXdgConfigHome = getXdgConfigHome;
+exports.getXdgDataHome = getXdgDataHome;