@socketsecurity/lib 5.28.0 → 6.0.1

package/dist/env/socket.js

@@ -20,28 +20,54 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var socket_exports = {};
 __export(socket_exports, {
+  getMcpHttpMode: () => getMcpHttpMode,
+  getMcpPort: () => getMcpPort,
   getSocketAcceptRisks: () => getSocketAcceptRisks,
   getSocketApiBaseUrl: () => getSocketApiBaseUrl,
   getSocketApiProxy: () => getSocketApiProxy,
   getSocketApiTimeout: () => getSocketApiTimeout,
   getSocketApiToken: () => getSocketApiToken,
+  getSocketApiUrl: () => getSocketApiUrl,
+  getSocketBranchName: () => getSocketBranchName,
   getSocketCacacheDirEnv: () => getSocketCacacheDirEnv,
+  getSocketCloudAuthUrl: () => getSocketCloudAuthUrl,
+  getSocketCloudClientId: () => getSocketCloudClientId,
+  getSocketCloudClientSecret: () => getSocketCloudClientSecret,
+  getSocketCloudIntrospectUrl: () => getSocketCloudIntrospectUrl,
+  getSocketCloudTokenUrl: () => getSocketCloudTokenUrl,
+  getSocketCloudUserinfoUrl: () => getSocketCloudUserinfoUrl,
   getSocketConfig: () => getSocketConfig,
   getSocketDebug: () => getSocketDebug,
   getSocketDlxDirEnv: () => getSocketDlxDirEnv,
   getSocketHome: () => getSocketHome,
   getSocketNoApiToken: () => getSocketNoApiToken,
   getSocketNpmRegistry: () => getSocketNpmRegistry,
+  getSocketOauthIntrospectionClientId: () => getSocketOauthIntrospectionClientId,
+  getSocketOauthIntrospectionClientSecret: () => getSocketOauthIntrospectionClientSecret,
+  getSocketOauthIssuer: () => getSocketOauthIssuer,
+  getSocketOauthRequiredScopes: () => getSocketOauthRequiredScopes,
   getSocketOrgSlug: () => getSocketOrgSlug,
   getSocketRegistryUrl: () => getSocketRegistryUrl,
-  getSocketViewAllRisks: () => getSocketViewAllRisks
+  getSocketRepositoryName: () => getSocketRepositoryName,
+  getSocketViewAllRisks: () => getSocketViewAllRisks,
+  getTrustProxy: () => getTrustProxy
 });
 module.exports = __toCommonJS(socket_exports);
-var import_helpers = require("./helpers");
+var import_boolean = require("./boolean");
+var import_number = require("./number");
 var import_rewire = require("./rewire");
 // @__NO_SIDE_EFFECTS__
+function getMcpHttpMode() {
+  return (0, import_rewire.getEnvValue)("MCP_HTTP_MODE") === "true";
+}
+// @__NO_SIDE_EFFECTS__
+function getMcpPort() {
+  const parsed = (0, import_number.envAsNumber)((0, import_rewire.getEnvValue)("MCP_PORT"));
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 3e3;
+}
+// @__NO_SIDE_EFFECTS__
 function getSocketAcceptRisks() {
-  return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_ACCEPT_RISKS"));
+  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_ACCEPT_RISKS"));
 }
 // @__NO_SIDE_EFFECTS__
 function getSocketApiBaseUrl() {
@@ -53,17 +79,49 @@ function getSocketApiProxy() {
 }
 // @__NO_SIDE_EFFECTS__
 function getSocketApiTimeout() {
-  return (0, import_helpers.envAsNumber)((0, import_rewire.getEnvValue)("SOCKET_API_TIMEOUT"));
+  return (0, import_number.envAsNumber)((0, import_rewire.getEnvValue)("SOCKET_API_TIMEOUT"));
 }
 // @__NO_SIDE_EFFECTS__
 function getSocketApiToken() {
-  return (0, import_rewire.getEnvValue)("SOCKET_API_TOKEN");
+  return (0, import_rewire.getEnvValue)("SOCKET_API_TOKEN") || (0, import_rewire.getEnvValue)("SOCKET_API_KEY") || (0, import_rewire.getEnvValue)("SOCKET_CLI_API_TOKEN") || (0, import_rewire.getEnvValue)("SOCKET_CLI_API_KEY") || (0, import_rewire.getEnvValue)("SOCKET_SECURITY_API_TOKEN") || (0, import_rewire.getEnvValue)("SOCKET_SECURITY_API_KEY");
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketApiUrl() {
+  return (0, import_rewire.getEnvValue)("SOCKET_API_URL");
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketBranchName() {
+  return (0, import_rewire.getEnvValue)("SOCKET_BRANCH_NAME");
 }
 // @__NO_SIDE_EFFECTS__
 function getSocketCacacheDirEnv() {
   return (0, import_rewire.getEnvValue)("SOCKET_CACACHE_DIR");
 }
 // @__NO_SIDE_EFFECTS__
+function getSocketCloudAuthUrl() {
+  return (0, import_rewire.getEnvValue)("SOCKET_CLOUD_AUTH_URL");
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketCloudClientId() {
+  return (0, import_rewire.getEnvValue)("SOCKET_CLOUD_CLIENT_ID");
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketCloudClientSecret() {
+  return (0, import_rewire.getEnvValue)("SOCKET_CLOUD_CLIENT_SECRET");
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketCloudIntrospectUrl() {
+  return (0, import_rewire.getEnvValue)("SOCKET_CLOUD_INTROSPECT_URL");
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketCloudTokenUrl() {
+  return (0, import_rewire.getEnvValue)("SOCKET_CLOUD_TOKEN_URL");
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketCloudUserinfoUrl() {
+  return (0, import_rewire.getEnvValue)("SOCKET_CLOUD_USERINFO_URL");
+}
+// @__NO_SIDE_EFFECTS__
 function getSocketConfig() {
   return (0, import_rewire.getEnvValue)("SOCKET_CONFIG");
 }
@@ -81,13 +139,29 @@ function getSocketHome() {
 }
 // @__NO_SIDE_EFFECTS__
 function getSocketNoApiToken() {
-  return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_NO_API_TOKEN"));
+  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_NO_API_TOKEN"));
 }
 // @__NO_SIDE_EFFECTS__
 function getSocketNpmRegistry() {
   return (0, import_rewire.getEnvValue)("SOCKET_NPM_REGISTRY");
 }
 // @__NO_SIDE_EFFECTS__
+function getSocketOauthIntrospectionClientId() {
+  return (0, import_rewire.getEnvValue)("SOCKET_OAUTH_INTROSPECTION_CLIENT_ID") ?? "";
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketOauthIntrospectionClientSecret() {
+  return (0, import_rewire.getEnvValue)("SOCKET_OAUTH_INTROSPECTION_CLIENT_SECRET") ?? "";
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketOauthIssuer() {
+  return (0, import_rewire.getEnvValue)("SOCKET_OAUTH_ISSUER") ?? "";
+}
+// @__NO_SIDE_EFFECTS__
+function getSocketOauthRequiredScopes() {
+  return (0, import_rewire.getEnvValue)("SOCKET_OAUTH_REQUIRED_SCOPES") ?? "packages:list";
+}
+// @__NO_SIDE_EFFECTS__
 function getSocketOrgSlug() {
   return (0, import_rewire.getEnvValue)("SOCKET_ORG_SLUG");
 }
@@ -96,24 +170,49 @@ function getSocketRegistryUrl() {
   return (0, import_rewire.getEnvValue)("SOCKET_REGISTRY_URL");
 }
 // @__NO_SIDE_EFFECTS__
+function getSocketRepositoryName() {
+  return (0, import_rewire.getEnvValue)("SOCKET_REPOSITORY_NAME") || // Used by Coana.
+  (0, import_rewire.getEnvValue)("SOCKET_REPO_NAME");
+}
+// @__NO_SIDE_EFFECTS__
 function getSocketViewAllRisks() {
-  return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_VIEW_ALL_RISKS"));
+  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_VIEW_ALL_RISKS"));
+}
+// @__NO_SIDE_EFFECTS__
+function getTrustProxy() {
+  return (0, import_rewire.getEnvValue)("TRUST_PROXY") === "true";
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getMcpHttpMode,
+  getMcpPort,
   getSocketAcceptRisks,
   getSocketApiBaseUrl,
   getSocketApiProxy,
   getSocketApiTimeout,
   getSocketApiToken,
+  getSocketApiUrl,
+  getSocketBranchName,
   getSocketCacacheDirEnv,
+  getSocketCloudAuthUrl,
+  getSocketCloudClientId,
+  getSocketCloudClientSecret,
+  getSocketCloudIntrospectUrl,
+  getSocketCloudTokenUrl,
+  getSocketCloudUserinfoUrl,
   getSocketConfig,
   getSocketDebug,
   getSocketDlxDirEnv,
   getSocketHome,
   getSocketNoApiToken,
   getSocketNpmRegistry,
+  getSocketOauthIntrospectionClientId,
+  getSocketOauthIntrospectionClientSecret,
+  getSocketOauthIssuer,
+  getSocketOauthRequiredScopes,
   getSocketOrgSlug,
   getSocketRegistryUrl,
-  getSocketViewAllRisks
+  getSocketRepositoryName,
+  getSocketViewAllRisks,
+  getTrustProxy
 });

package/dist/env/string.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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.
+ */
+import type { EnvAsStringOptions } from './types';
+/**
+ * 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
+ */
+export declare function envAsString(value: unknown, defaultValueOrOptions?: string | EnvAsStringOptions | undefined): string;

package/dist/env/string.js

@@ -0,0 +1,47 @@
+"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__
+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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  envAsString
+});

package/dist/env/temp-dir.d.ts

@@ -1,49 +1,46 @@
 /**
- * @fileoverview Temporary directory environment variable getters.
- * Different platforms use different environment variables for temp directories.
+ * @file Temporary directory environment variable getters. Different platforms
+ *   use different environment variables for temp directories.
  */
 /**
- * TEMP environment variable.
- * Windows temporary directory path.
- *
- * @returns The Windows temp directory path, or `undefined` if not set
+ * TEMP environment variable. Windows temporary directory path.
  *
  * @example
- * ```typescript
- * import { getTemp } from '@socketsecurity/lib/env/temp-dir'
+ *   ;```typescript
+ *   import { getTemp } from '@socketsecurity/lib/env/temp-dir'
+ *
+ *   const temp = getTemp()
+ *   // e.g. 'C:\\Windows\\Temp' or undefined
+ *   ```
  *
- * const temp = getTemp()
- * // e.g. 'C:\\Windows\\Temp' or undefined
- * ```
+ * @returns The Windows temp directory path, or `undefined` if not set
  */
 export declare function getTemp(): string | undefined;
 /**
- * TMP environment variable.
- * Alternative temporary directory path.
- *
- * @returns The alternative temp directory path, or `undefined` if not set
+ * TMP environment variable. Alternative temporary directory path.
  *
  * @example
- * ```typescript
- * import { getTmp } from '@socketsecurity/lib/env/temp-dir'
+ *   ;```typescript
+ *   import { getTmp } from '@socketsecurity/lib/env/temp-dir'
  *
- * const tmp = getTmp()
- * // e.g. '/tmp' or undefined
- * ```
+ *   const tmp = getTmp()
+ *   // e.g. '/tmp' or undefined
+ *   ```
+ *
+ * @returns The alternative temp directory path, or `undefined` if not set
  */
 export declare function getTmp(): string | undefined;
 /**
- * TMPDIR environment variable.
- * Unix/macOS temporary directory path.
- *
- * @returns The Unix/macOS temp directory path, or `undefined` if not set
+ * TMPDIR environment variable. Unix/macOS temporary directory path.
  *
  * @example
- * ```typescript
- * import { getTmpdir } from '@socketsecurity/lib/env/temp-dir'
+ *   ;```typescript
+ *   import { getTmpdir } from '@socketsecurity/lib/env/temp-dir'
+ *
+ *   const tmpdir = getTmpdir()
+ *   // e.g. '/tmp' or undefined
+ *   ```
  *
- * const tmpdir = getTmpdir()
- * // e.g. '/tmp' or undefined
- * ```
+ * @returns The Unix/macOS temp directory path, or `undefined` if not set
  */
 export declare function getTmpdir(): string | undefined;

package/dist/env/term.d.ts

@@ -1,19 +1,19 @@
 /**
- * @fileoverview TERM environment variable getter.
- * Exports `getTerm()`, returning the `TERM` terminal type identifier (for
- * example `xterm-256color`) or `undefined` when unset.
+ * @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.
  *
- * @returns The terminal type identifier, or `undefined` if not set
- *
  * @example
- * ```typescript
- * import { getTerm } from '@socketsecurity/lib/env/term'
+ *   ;```typescript
+ *   import { getTerm } from '@socketsecurity/lib/env/term'
  *
- * const term = getTerm()
- * // e.g. 'xterm-256color' or undefined
- * ```
+ *   const term = getTerm()
+ *   // e.g. 'xterm-256color' or undefined
+ *   ```
+ *
+ * @returns The terminal type identifier, or `undefined` if not set
  */
 export declare function getTerm(): string | undefined;

package/dist/env/test.d.ts

@@ -1,51 +1,49 @@
 /**
- * @fileoverview Test environment variable getters and detection.
- * Provides access to test framework environment variables and utilities.
+ * @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.
- *
- * @returns The Jest worker ID string, or empty string if not set
+ * JEST_WORKER_ID environment variable. Set when running tests with Jest.
  *
  * @example
- * ```typescript
- * import { getJestWorkerId } from '@socketsecurity/lib/env/test'
+ *   ;```typescript
+ *   import { getJestWorkerId } from '@socketsecurity/lib/env/test'
+ *
+ *   const workerId = getJestWorkerId()
+ *   // e.g. '1' when running in Jest, or ''
+ *   ```
  *
- * const workerId = getJestWorkerId()
- * // e.g. '1' when running in Jest, or ''
- * ```
+ * @returns The Jest worker ID string, or empty string if not set
  */
 export declare function getJestWorkerId(): string;
 /**
- * VITEST environment variable.
- * Set when running tests with Vitest.
- *
- * @returns `true` if running in Vitest, `false` otherwise
+ * VITEST environment variable. Set when running tests with Vitest.
  *
  * @example
- * ```typescript
- * import { getVitest } from '@socketsecurity/lib/env/test'
+ *   ;```typescript
+ *   import { getVitest } from '@socketsecurity/lib/env/test'
  *
- * if (getVitest()) {
- *   console.log('Running in Vitest')
- * }
- * ```
+ *   if (getVitest()) {
+ *     console.log('Running in Vitest')
+ *   }
+ *   ```
+ *
+ * @returns `true` if running in Vitest, `false` otherwise
  */
 export declare function getVitest(): boolean;
 /**
- * Check if code is running in a test environment.
- * Checks NODE_ENV, VITEST, and JEST_WORKER_ID.
- *
- * @returns `true` if running in a test environment, `false` otherwise
+ * 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'
+ *   ;```typescript
+ *   import { isTest } from '@socketsecurity/lib/env/test'
+ *
+ *   if (isTest()) {
+ *     console.log('Running in test environment')
+ *   }
+ *   ```
  *
- * if (isTest()) {
- *   console.log('Running in test environment')
- * }
- * ```
+ * @returns `true` if running in a test environment, `false` otherwise
  */
 export declare function isTest(): boolean;

package/dist/env/test.js

@@ -25,20 +25,21 @@ __export(test_exports, {
   isTest: () => isTest
 });
 module.exports = __toCommonJS(test_exports);
-var import_helpers = require("./helpers");
+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__
 function getJestWorkerId() {
-  return (0, import_helpers.envAsString)((0, import_rewire.getEnvValue)("JEST_WORKER_ID"));
+  return (0, import_string.envAsString)((0, import_rewire.getEnvValue)("JEST_WORKER_ID"));
 }
 // @__NO_SIDE_EFFECTS__
 function getVitest() {
-  return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("VITEST"));
+  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("VITEST"));
 }
 // @__NO_SIDE_EFFECTS__
 function isTest() {
-  const nodeEnv = (0, import_helpers.envAsString)((0, import_node_env.getNodeEnv)());
+  const nodeEnv = (0, import_string.envAsString)((0, import_node_env.getNodeEnv)());
   return nodeEnv === "test" || /* @__PURE__ */ getVitest() || !!/* @__PURE__ */ getJestWorkerId();
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/env/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @file Public type surface for the cross-cutting `env/*` leaves split out of
+ *   the legacy single-file `env.ts` — option bags consumed by `envAsBoolean` /
+ *   `envAsNumber` / `envAsString`. The pre-existing concern-specific leaves in
+ *   this directory (ci, debug, github, …) keep their own ad-hoc types. Pure
+ *   types, no runtime side effects.
+ */
+/**
+ * Options for `envAsBoolean`.
+ */
+export interface EnvAsBooleanOptions {
+    /**
+     * Default when value is null/undefined. @default false.
+     */
+    defaultValue?: boolean | undefined;
+    /**
+     * Whether to trim whitespace from string values before matching. When
+     * `false`, `' true '` is NOT recognised as truthy — only exact matches.
+     *
+     * @default true
+     */
+    trim?: boolean | undefined;
+}
+/**
+ * Options for `envAsNumber`.
+ */
+export interface EnvAsNumberOptions {
+    /**
+     * Whether to return `±Infinity` when input parses to infinity. When `false`
+     * (default), infinities and NaN are coerced to `defaultValue`.
+     *
+     * @default false
+     */
+    allowInfinity?: boolean | undefined;
+    /**
+     * Default when value is not a finite number. @default 0.
+     */
+    defaultValue?: number | undefined;
+    /**
+     * Parse mode. `'int'` (default) uses `parseInt(_, 10)` — integer only.
+     * `'float'` uses `Number()` — decimals preserved.
+     *
+     * @default 'int'
+     */
+    mode?: 'int' | 'float' | undefined;
+}
+/**
+ * Options for `envAsString`.
+ */
+export interface EnvAsStringOptions {
+    /**
+     * Default when value is null/undefined. @default ''
+     */
+    defaultValue?: string | undefined;
+    /**
+     * Whether to trim whitespace from string values. `true` (default) trims. Set
+     * `false` to preserve whitespace (helpers.envAsString semantics).
+     *
+     * @default true
+     */
+    trim?: boolean | undefined;
+}

package/dist/env/types.js

@@ -0,0 +1,18 @@
+"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);

package/dist/env/windows.d.ts

@@ -1,64 +1,63 @@
 /**
- * @fileoverview Windows environment variable getters.
- * Provides access to Windows-specific user directory paths.
+ * @file Windows environment variable getters. Provides access to
+ *   Windows-specific user directory paths.
  */
 /**
- * APPDATA environment variable.
- * Points to the Application Data directory on Windows.
- *
- * @returns The Windows AppData roaming directory, or `undefined` if not set
+ * APPDATA environment variable. Points to the Application Data directory on
+ * Windows.
  *
  * @example
- * ```typescript
- * import { getAppdata } from '@socketsecurity/lib/env/windows'
+ *   ;```typescript
+ *   import { getAppdata } from '@socketsecurity/lib/env/windows'
  *
- * const appdata = getAppdata()
- * // e.g. 'C:\\Users\\Public\\AppData\\Roaming' or undefined
- * ```
+ *   const appdata = getAppdata()
+ *   // e.g. 'C:\\Users\\Public\\AppData\\Roaming' or undefined
+ *   ```
+ *
+ * @returns The Windows AppData roaming directory, or `undefined` if not set
  */
 export declare function getAppdata(): string | undefined;
 /**
- * COMSPEC environment variable.
- * Points to the Windows command processor (typically cmd.exe).
- *
- * @returns The path to the command processor, or `undefined` if not set
+ * COMSPEC environment variable. Points to the Windows command processor
+ * (typically cmd.exe).
  *
  * @example
- * ```typescript
- * import { getComspec } from '@socketsecurity/lib/env/windows'
+ *   ;```typescript
+ *   import { getComspec } from '@socketsecurity/lib/env/windows'
  *
- * const comspec = getComspec()
- * // e.g. 'C:\\Windows\\system32\\cmd.exe' or undefined
- * ```
+ *   const comspec = getComspec()
+ *   // e.g. 'C:\\Windows\\system32\\cmd.exe' or undefined
+ *   ```
+ *
+ * @returns The path to the command processor, or `undefined` if not set
  */
 export declare function getComspec(): string | undefined;
 /**
- * LOCALAPPDATA environment variable.
- * Points to the Local Application Data directory on Windows.
- *
- * @returns The Windows local AppData directory, or `undefined` if not set
+ * LOCALAPPDATA environment variable. Points to the Local Application Data
+ * directory on Windows.
  *
  * @example
- * ```typescript
- * import { getLocalappdata } from '@socketsecurity/lib/env/windows'
+ *   ;```typescript
+ *   import { getLocalappdata } from '@socketsecurity/lib/env/windows'
  *
- * const localAppdata = getLocalappdata()
- * // e.g. 'C:\\Users\\Public\\AppData\\Local' or undefined
- * ```
+ *   const localAppdata = getLocalappdata()
+ *   // e.g. 'C:\\Users\\Public\\AppData\\Local' or undefined
+ *   ```
+ *
+ * @returns The Windows local AppData directory, or `undefined` if not set
  */
 export declare function getLocalappdata(): string | undefined;
 /**
- * USERPROFILE environment variable.
- * Windows user home directory path.
- *
- * @returns The Windows user profile directory, or `undefined` if not set
+ * USERPROFILE environment variable. Windows user home directory path.
  *
  * @example
- * ```typescript
- * import { getUserprofile } from '@socketsecurity/lib/env/windows'
+ *   ;```typescript
+ *   import { getUserprofile } from '@socketsecurity/lib/env/windows'
  *
- * const userprofile = getUserprofile()
- * // e.g. 'C:\\Users\\Public' or undefined
- * ```
+ *   const userprofile = getUserprofile()
+ *   // e.g. 'C:\\Users\\Public' or undefined
+ *   ```
+ *
+ * @returns The Windows user profile directory, or `undefined` if not set
  */
 export declare function getUserprofile(): string | undefined;