@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/env/shell.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 shell_exports = {};
-__export(shell_exports, {
-  getShell: () => getShell
-});
-module.exports = __toCommonJS(shell_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/shell.ts
+/**
+* @file SHELL environment variable getter. Exports `getShell()`, returning the
+*   Unix/macOS `SHELL` path (for example `/bin/zsh`) or `undefined` when the
+*   variable is unset.
+*/
+/**
+* Returns the value of the SHELL environment variable.
+*
+* @example
+*   ;```typescript
+*   import { getShell } from '@socketsecurity/lib/env/shell'
+*
+*   const shell = getShell()
+*   // e.g. '/bin/zsh' or '/bin/bash'
+*   ```
+*
+* @returns The user's default shell path, or `undefined` if not set
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getShell() {
-  return (0, import_rewire.getEnvValue)("SHELL");
+	return require_env_rewire.getEnvValue("SHELL");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getShell
-});
+
+//#endregion
+exports.getShell = getShell;

package/dist/env/socket-cli.js

@@ -1,108 +1,260 @@
 "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 socket_cli_exports = {};
-__export(socket_cli_exports, {
-  getSocketCliAcceptRisks: () => getSocketCliAcceptRisks,
-  getSocketCliApiBaseUrl: () => getSocketCliApiBaseUrl,
-  getSocketCliApiProxy: () => getSocketCliApiProxy,
-  getSocketCliApiTimeout: () => getSocketCliApiTimeout,
-  getSocketCliBootstrapCacheDir: () => getSocketCliBootstrapCacheDir,
-  getSocketCliBootstrapSpec: () => getSocketCliBootstrapSpec,
-  getSocketCliConfig: () => getSocketCliConfig,
-  getSocketCliFix: () => getSocketCliFix,
-  getSocketCliGithubToken: () => getSocketCliGithubToken,
-  getSocketCliNoApiToken: () => getSocketCliNoApiToken,
-  getSocketCliOptimize: () => getSocketCliOptimize,
-  getSocketCliOrgSlug: () => getSocketCliOrgSlug,
-  getSocketCliViewAllRisks: () => getSocketCliViewAllRisks
-});
-module.exports = __toCommonJS(socket_cli_exports);
-var import_boolean = require("./boolean");
-var import_number = require("./number");
-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_number = require('./number.js');
+
+//#region src/env/socket-cli.ts
+/**
+* @file Socket CLI environment variables. Provides typed getters for
+*   SOCKET_CLI_* environment variables (excluding shadow).
+*/
+/**
+* Whether to accept all Socket CLI risks (alternative name).
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliAcceptRisks } from '@socketsecurity/lib/env/socket-cli'
+*
+*   if (getSocketCliAcceptRisks()) {
+*     console.log('All risks accepted')
+*   }
+*   ```
+*
+* @returns Whether to accept all risks
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliAcceptRisks() {
-  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_CLI_ACCEPT_RISKS"));
+	return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_CLI_ACCEPT_RISKS"));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Socket CLI API base URL (alternative name). Checks SOCKET_CLI_API_BASE_URL
+* first, then falls back to legacy SOCKET_SECURITY_API_BASE_URL.
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliApiBaseUrl } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const baseUrl = getSocketCliApiBaseUrl()
+*   // e.g. 'https://api.socket.dev' or undefined
+*   ```
+*
+* @returns API base URL or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliApiBaseUrl() {
-  return (0, import_rewire.getEnvValue)("SOCKET_CLI_API_BASE_URL") || (0, import_rewire.getEnvValue)("SOCKET_SECURITY_API_BASE_URL");
+	return require_env_rewire.getEnvValue("SOCKET_CLI_API_BASE_URL") || require_env_rewire.getEnvValue("SOCKET_SECURITY_API_BASE_URL");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Proxy URL for Socket CLI API requests (alternative name). Checks
+* SOCKET_CLI_API_PROXY, SOCKET_SECURITY_API_PROXY, then standard proxy env
+* vars. Follows the same precedence as v1.x: HTTPS_PROXY → https_proxy →
+* HTTP_PROXY → http_proxy.
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliApiProxy } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const proxy = getSocketCliApiProxy()
+*   // e.g. 'http://proxy.example.com:8080' or undefined
+*   ```
+*
+* @returns API proxy URL or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliApiProxy() {
-  return (0, import_rewire.getEnvValue)("SOCKET_CLI_API_PROXY") || (0, import_rewire.getEnvValue)("SOCKET_SECURITY_API_PROXY") || (0, import_rewire.getEnvValue)("HTTPS_PROXY") || (0, import_rewire.getEnvValue)("https_proxy") || (0, import_rewire.getEnvValue)("HTTP_PROXY") || (0, import_rewire.getEnvValue)("http_proxy");
+	return require_env_rewire.getEnvValue("SOCKET_CLI_API_PROXY") || require_env_rewire.getEnvValue("SOCKET_SECURITY_API_PROXY") || require_env_rewire.getEnvValue("HTTPS_PROXY") || require_env_rewire.getEnvValue("https_proxy") || require_env_rewire.getEnvValue("HTTP_PROXY") || require_env_rewire.getEnvValue("http_proxy");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Timeout in milliseconds for Socket CLI API requests (alternative name).
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliApiTimeout } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const timeout = getSocketCliApiTimeout()
+*   // e.g. 30000 or 0 if not set
+*   ```
+*
+* @returns API timeout in milliseconds
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliApiTimeout() {
-  return (0, import_number.envAsNumber)((0, import_rewire.getEnvValue)("SOCKET_CLI_API_TIMEOUT"));
+	return /* @__PURE__ */ require_env_number.envAsNumber(require_env_rewire.getEnvValue("SOCKET_CLI_API_TIMEOUT"));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Bootstrap cache directory path. Set by bootstrap wrappers to pass dlx cache
+* location to CLI.
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliBootstrapCacheDir } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const cacheDir = getSocketCliBootstrapCacheDir()
+*   // e.g. '/tmp/.socket-cli-cache' or undefined
+*   ```
+*
+* @returns Bootstrap cache directory or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliBootstrapCacheDir() {
-  return (0, import_rewire.getEnvValue)("SOCKET_CLI_BOOTSTRAP_CACHE_DIR");
+	return require_env_rewire.getEnvValue("SOCKET_CLI_BOOTSTRAP_CACHE_DIR");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Bootstrap package spec (e.g., @socketsecurity/cli@^2.0.11). Set by bootstrap
+* wrappers (SEA/smol/npm) to pass package spec to CLI.
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliBootstrapSpec } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const spec = getSocketCliBootstrapSpec()
+*   // e.g. '@socketsecurity/cli@^2.0.11' or undefined
+*   ```
+*
+* @returns Bootstrap package spec or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliBootstrapSpec() {
-  return (0, import_rewire.getEnvValue)("SOCKET_CLI_BOOTSTRAP_SPEC");
+	return require_env_rewire.getEnvValue("SOCKET_CLI_BOOTSTRAP_SPEC");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Socket CLI configuration file path (alternative name).
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliConfig } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const config = getSocketCliConfig()
+*   // e.g. '/tmp/project/socket.yml' or undefined
+*   ```
+*
+* @returns Config file path or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliConfig() {
-  return (0, import_rewire.getEnvValue)("SOCKET_CLI_CONFIG");
+	return require_env_rewire.getEnvValue("SOCKET_CLI_CONFIG");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Controls Socket CLI fix mode.
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliFix } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const fix = getSocketCliFix()
+*   // e.g. 'true' or undefined
+*   ```
+*
+* @returns Fix mode value or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliFix() {
-  return (0, import_rewire.getEnvValue)("SOCKET_CLI_FIX");
+	return require_env_rewire.getEnvValue("SOCKET_CLI_FIX");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Socket CLI GitHub authentication token. Checks SOCKET_CLI_GITHUB_TOKEN,
+* SOCKET_SECURITY_GITHUB_PAT, then falls back to GITHUB_TOKEN.
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliGithubToken } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const token = getSocketCliGithubToken()
+*   // e.g. 'ghp_abc123...' or undefined
+*   ```
+*
+* @returns GitHub token or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliGithubToken() {
-  return (0, import_rewire.getEnvValue)("SOCKET_CLI_GITHUB_TOKEN") || (0, import_rewire.getEnvValue)("SOCKET_SECURITY_GITHUB_PAT") || (0, import_rewire.getEnvValue)("GITHUB_TOKEN");
+	return require_env_rewire.getEnvValue("SOCKET_CLI_GITHUB_TOKEN") || require_env_rewire.getEnvValue("SOCKET_SECURITY_GITHUB_PAT") || require_env_rewire.getEnvValue("GITHUB_TOKEN");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Whether to skip Socket CLI API token requirement (alternative name).
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliNoApiToken } from '@socketsecurity/lib/env/socket-cli'
+*
+*   if (getSocketCliNoApiToken()) {
+*     console.log('API token requirement skipped')
+*   }
+*   ```
+*
+* @returns Whether to skip API token requirement
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliNoApiToken() {
-  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_CLI_NO_API_TOKEN"));
+	return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_CLI_NO_API_TOKEN"));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Controls Socket CLI optimization mode.
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliOptimize } from '@socketsecurity/lib/env/socket-cli'
+*
+*   if (getSocketCliOptimize()) {
+*     console.log('Optimization mode enabled')
+*   }
+*   ```
+*
+* @returns Whether optimization mode is enabled
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliOptimize() {
-  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_CLI_OPTIMIZE"));
+	return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_CLI_OPTIMIZE"));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Socket CLI organization slug identifier (alternative name). Checks
+* SOCKET_CLI_ORG_SLUG first, then falls back to SOCKET_ORG_SLUG.
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliOrgSlug } from '@socketsecurity/lib/env/socket-cli'
+*
+*   const slug = getSocketCliOrgSlug()
+*   // e.g. 'my-org' or undefined
+*   ```
+*
+* @returns Organization slug or undefined
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliOrgSlug() {
-  return (0, import_rewire.getEnvValue)("SOCKET_CLI_ORG_SLUG") || (0, import_rewire.getEnvValue)("SOCKET_ORG_SLUG");
+	return require_env_rewire.getEnvValue("SOCKET_CLI_ORG_SLUG") || require_env_rewire.getEnvValue("SOCKET_ORG_SLUG");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Whether to view all Socket CLI risks (alternative name).
+*
+* @example
+*   ;```typescript
+*   import { getSocketCliViewAllRisks } from '@socketsecurity/lib/env/socket-cli'
+*
+*   if (getSocketCliViewAllRisks()) {
+*     console.log('Viewing all risks')
+*   }
+*   ```
+*
+* @returns Whether to view all risks
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getSocketCliViewAllRisks() {
-  return (0, import_boolean.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_CLI_VIEW_ALL_RISKS"));
+	return /* @__PURE__ */ require_env_boolean.envAsBoolean(require_env_rewire.getEnvValue("SOCKET_CLI_VIEW_ALL_RISKS"));
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getSocketCliAcceptRisks,
-  getSocketCliApiBaseUrl,
-  getSocketCliApiProxy,
-  getSocketCliApiTimeout,
-  getSocketCliBootstrapCacheDir,
-  getSocketCliBootstrapSpec,
-  getSocketCliConfig,
-  getSocketCliFix,
-  getSocketCliGithubToken,
-  getSocketCliNoApiToken,
-  getSocketCliOptimize,
-  getSocketCliOrgSlug,
-  getSocketCliViewAllRisks
-});
+
+//#endregion
+exports.getSocketCliAcceptRisks = getSocketCliAcceptRisks;
+exports.getSocketCliApiBaseUrl = getSocketCliApiBaseUrl;
+exports.getSocketCliApiProxy = getSocketCliApiProxy;
+exports.getSocketCliApiTimeout = getSocketCliApiTimeout;
+exports.getSocketCliBootstrapCacheDir = getSocketCliBootstrapCacheDir;
+exports.getSocketCliBootstrapSpec = getSocketCliBootstrapSpec;
+exports.getSocketCliConfig = getSocketCliConfig;
+exports.getSocketCliFix = getSocketCliFix;
+exports.getSocketCliGithubToken = getSocketCliGithubToken;
+exports.getSocketCliNoApiToken = getSocketCliNoApiToken;
+exports.getSocketCliOptimize = getSocketCliOptimize;
+exports.getSocketCliOrgSlug = getSocketCliOrgSlug;
+exports.getSocketCliViewAllRisks = getSocketCliViewAllRisks;