@socketsecurity/lib 6.0.6 → 6.0.8

package/dist/arrays/join.d.ts

@@ -1,13 +1,17 @@
 /**
  * @file Grammatical list joiners via `Intl.ListFormat` — Oxford-comma aware and
- *   locale-correct. `joinAnd` ("a, b, and c"), `joinOr` ("a, b, or c").
+ *   locale-correct. `joinList` (generalized), `joinAnd` ("a, b, and c"),
+ *   `joinOr` ("a, b, or c").
  */
+export interface JoinListOptions {
+    with?: string | undefined;
+}
 /**
  * Join array elements with proper "and" conjunction formatting.
  *
  * Formats an array of strings into a grammatically correct list using "and" as
  * the conjunction. Uses `Intl.ListFormat` for proper English formatting with
- * Oxford comma support.
+ * Oxford comma support. Delegates to `joinList`.
  *
  * @example
  *   ```ts
@@ -38,12 +42,42 @@
  * @returns Formatted string with proper "and" conjunction
  */
 export declare function joinAnd(arr: string[] | readonly string[]): string;
+/**
+ * Generalized list joiner covering bare join, comma-list, and
+ * conjunction/disjunction via `Intl.ListFormat`.
+ *
+ * - No options: bare concatenation (`'abc'`)
+ * - `{ with: 'and' }`: Oxford-comma "and" list via `Intl.ListFormat` (`'a, b, and
+ *   c'`)
+ * - `{ with: 'or' }`: Oxford-comma "or" list via `Intl.ListFormat` (`'a, b, or
+ *   c'`)
+ * - `{ with: <any other string> }`: `items.join(sep)` — e.g. `','` → `'a,b,c'`,
+ *   `', '` → `'a, b, c'`, `' '` → `'a b c'`
+ *
+ * Each item is coerced via `String()` before formatting.
+ *
+ * @example
+ *   ;```ts
+ *   joinList(['a', 'b', 'c'])                  // 'abc'
+ *   joinList(['a', 'b', 'c'], { with: ', ' })  // 'a, b, c'
+ *   joinList(['a', 'b', 'c'], { with: ' ' })   // 'a b c'
+ *   joinList(['a', 'b', 'c'], { with: 'and' }) // 'a, b, and c'
+ *   joinList(['a', 'b', 'c'], { with: 'or' })  // 'a, b, or c'
+ *   joinList([1, 2, 3], { with: 'and' })        // '1, 2, and 3'
+ *   ```
+ *
+ * @param items - Items to join (can be readonly, any type)
+ * @param options - Formatting options (optional)
+ *
+ * @returns Formatted string
+ */
+export declare function joinList(items: readonly unknown[], options?: JoinListOptions): string;
 /**
  * Join array elements with proper "or" disjunction formatting.
  *
  * Formats an array of strings into a grammatically correct list using "or" as
  * the disjunction. Uses `Intl.ListFormat` for proper English formatting with
- * Oxford comma support.
+ * Oxford comma support. Delegates to `joinList`.
  *
  * @example
  *   ```ts

package/dist/arrays/join.js

@@ -6,14 +6,15 @@ const require_arrays__internal = require('./_internal.js');
 //#region src/arrays/join.ts
 /**
 * @file Grammatical list joiners via `Intl.ListFormat` — Oxford-comma aware and
-*   locale-correct. `joinAnd` ("a, b, and c"), `joinOr` ("a, b, or c").
+*   locale-correct. `joinList` (generalized), `joinAnd` ("a, b, and c"),
+*   `joinOr` ("a, b, or c").
 */
 /**
 * Join array elements with proper "and" conjunction formatting.
 *
 * Formats an array of strings into a grammatically correct list using "and" as
 * the conjunction. Uses `Intl.ListFormat` for proper English formatting with
-* Oxford comma support.
+* Oxford comma support. Delegates to `joinList`.
 *
 * @example
 *   ```ts
@@ -43,16 +44,55 @@ const require_arrays__internal = require('./_internal.js');
 *
 * @returns Formatted string with proper "and" conjunction
 */
-/*@__NO_SIDE_EFFECTS__*/
 function joinAnd(arr) {
-	return (/* @__PURE__ */ require_arrays__internal.getConjunctionFormatter()).format(arr);
+	return joinList(arr, { with: "and" });
+}
+/**
+* Generalized list joiner covering bare join, comma-list, and
+* conjunction/disjunction via `Intl.ListFormat`.
+*
+* - No options: bare concatenation (`'abc'`)
+* - `{ with: 'and' }`: Oxford-comma "and" list via `Intl.ListFormat` (`'a, b, and
+*   c'`)
+* - `{ with: 'or' }`: Oxford-comma "or" list via `Intl.ListFormat` (`'a, b, or
+*   c'`)
+* - `{ with: <any other string> }`: `items.join(sep)` — e.g. `','` → `'a,b,c'`,
+*   `', '` → `'a, b, c'`, `' '` → `'a b c'`
+*
+* Each item is coerced via `String()` before formatting.
+*
+* @example
+*   ;```ts
+*   joinList(['a', 'b', 'c'])                  // 'abc'
+*   joinList(['a', 'b', 'c'], { with: ', ' })  // 'a, b, c'
+*   joinList(['a', 'b', 'c'], { with: ' ' })   // 'a b c'
+*   joinList(['a', 'b', 'c'], { with: 'and' }) // 'a, b, and c'
+*   joinList(['a', 'b', 'c'], { with: 'or' })  // 'a, b, or c'
+*   joinList([1, 2, 3], { with: 'and' })        // '1, 2, and 3'
+*   ```
+*
+* @param items - Items to join (can be readonly, any type)
+* @param options - Formatting options (optional)
+*
+* @returns Formatted string
+*/
+function joinList(items, options) {
+	options = {
+		__proto__: null,
+		...options
+	};
+	const w = options?.with;
+	if (w === "and") return require_arrays__internal.getConjunctionFormatter().format(items.map(String));
+	if (w === "or") return require_arrays__internal.getDisjunctionFormatter().format(items.map(String));
+	if (w !== void 0) return items.map(String).join(w);
+	return items.map(String).join("");
 }
 /**
 * Join array elements with proper "or" disjunction formatting.
 *
 * Formats an array of strings into a grammatically correct list using "or" as
 * the disjunction. Uses `Intl.ListFormat` for proper English formatting with
-* Oxford comma support.
+* Oxford comma support. Delegates to `joinList`.
 *
 * @example
 *   ```ts
@@ -82,11 +122,11 @@ function joinAnd(arr) {
 *
 * @returns Formatted string with proper "or" disjunction
 */
-/*@__NO_SIDE_EFFECTS__*/
 function joinOr(arr) {
-	return (/* @__PURE__ */ require_arrays__internal.getDisjunctionFormatter()).format(arr);
+	return joinList(arr, { with: "or" });
 }
 
 //#endregion
 exports.joinAnd = joinAnd;
+exports.joinList = joinList;
 exports.joinOr = joinOr;

package/dist/arrays/unique.js

@@ -39,7 +39,6 @@ const require_primordials_map_set = require('../primordials/map-set.js');
 *
 * @returns New array with duplicate values removed
 */
-/*@__NO_SIDE_EFFECTS__*/
 function arrayUnique(arr) {
 	return [...new require_primordials_map_set.SetCtor(arr)];
 }

package/dist/bin/_internal.d.ts

@@ -2,7 +2,7 @@
  * @file Private internals for `bin/*` modules — lazy `fs` / `path` accessors
  *   and the binary-resolution caches. Underscore prefix keeps this file out of
  *   the public exports map (see the `dist/<dir>/_<file>` ignore in
- *   scripts/fix/generate-package-exports.mts). Two caches:
+ *   scripts/post-build/make-package-exports.mts). Two caches:
  *
  *   1. `binPathCache` — maps a binary name to its first resolved path. Validated
  *      with `existsSync` before reuse so a stale cache doesn't survive a tool

package/dist/bin/_internal.js

@@ -10,7 +10,7 @@ const require_node_path = require('../node/path.js');
 * @file Private internals for `bin/*` modules — lazy `fs` / `path` accessors
 *   and the binary-resolution caches. Underscore prefix keeps this file out of
 *   the public exports map (see the `dist/<dir>/_<file>` ignore in
-*   scripts/fix/generate-package-exports.mts). Two caches:
+*   scripts/post-build/make-package-exports.mts). Two caches:
 *
 *   1. `binPathCache` — maps a binary name to its first resolved path. Validated
 *      with `existsSync` before reuse so a stale cache doesn't survive a tool

package/dist/bin/exec.js

@@ -40,14 +40,13 @@ const require_process_spawn_child = require('../process/spawn/child.js');
 *   await execBin('/usr/local/bin/node', ['script.js'], { cwd: '/tmp' })
 *   ```
 */
-/*@__NO_SIDE_EFFECTS__*/
 async function execBin(binPath, args, options) {
 	let resolvedPath;
-	if (/* @__PURE__ */ require_paths_predicates.isPath(binPath)) resolvedPath = /* @__PURE__ */ require_bin_resolve.resolveRealBinSync(binPath);
+	if (require_paths_predicates.isPath(binPath)) resolvedPath = require_bin_resolve.resolveRealBinSync(binPath);
 	else {
 		const cached = require_bin__internal.binPathCache.get(binPath);
 		/* c8 ignore start */
-		if (cached) if ((/* @__PURE__ */ require_node_fs.getNodeFs()).existsSync(cached)) resolvedPath = cached;
+		if (cached) if (require_node_fs.getNodeFs().existsSync(cached)) resolvedPath = cached;
 		else require_bin__internal.binPathCache.delete(binPath);
 		/* c8 ignore stop */
 		if (!resolvedPath) {

package/dist/bin/find.js

@@ -3,18 +3,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_constants_platform = require('../constants/platform.js');
+const require_env_home = require('../env/home.js');
+const require_env_xdg = require('../env/xdg.js');
 const require_primordials_array = require('../primordials/array.js');
 const require_node_fs = require('../node/fs.js');
 const require_node_path = require('../node/path.js');
 const require_bin_which = require('./which.js');
-const require_env_home = require('../env/home.js');
 const require_env_windows = require('../env/windows.js');
-const require_env_xdg = require('../env/xdg.js');
 const require_bin_shadow = require('./shadow.js');
-let src_external_which = require("../external/which");
-src_external_which = require_runtime.__toESM(src_external_which);
 let node_process = require("node:process");
 node_process = require_runtime.__toESM(node_process);
+let src_external_which = require("../external/which");
+src_external_which = require_runtime.__toESM(src_external_which);
 
 //#region src/bin/find.ts
 /**
@@ -45,8 +45,8 @@ node_process = require_runtime.__toESM(node_process);
 *   ```
 */
 function findRealBin(binName, commonPaths = []) {
-	const fs = /* @__PURE__ */ require_node_fs.getNodeFs();
-	const path = /* @__PURE__ */ require_node_path.getNodePath();
+	const fs = require_node_fs.getNodeFs();
+	const path = require_node_path.getNodePath();
 	for (const binPath of commonPaths) if (fs.existsSync(binPath)) return binPath;
 	/* c8 ignore start */
 	const allPaths = src_external_which.default.sync(binName, {
@@ -69,15 +69,15 @@ function findRealBin(binName, commonPaths = []) {
 *   ```
 */
 function findRealNpm() {
-	const fs = /* @__PURE__ */ require_node_fs.getNodeFs();
-	const path = /* @__PURE__ */ require_node_path.getNodePath();
+	const fs = require_node_fs.getNodeFs();
+	const path = require_node_path.getNodePath();
 	const nodeDir = path.dirname(node_process.default.execPath);
 	/* c8 ignore start */
 	const nodeDirCandidates = require_constants_platform.WIN32 ? [path.join(nodeDir, "npm.cmd"), path.join(nodeDir, "npm")] : [path.join(nodeDir, "npm")];
 	/* c8 ignore stop */
 	/* c8 ignore start */
 	for (const candidate of nodeDirCandidates) if (fs.existsSync(candidate)) return candidate;
-	const appdata = /* @__PURE__ */ require_env_windows.getAppdata();
+	const appdata = require_env_windows.getAppdata();
 	const result = findRealBin("npm", require_constants_platform.WIN32 ? [
 		appdata ? path.join(appdata, "npm", "npm.cmd") : "",
 		appdata ? path.join(appdata, "npm", "npm") : "",
@@ -104,11 +104,11 @@ function findRealNpm() {
 *   ```
 */
 function findRealPnpm() {
-	const path = /* @__PURE__ */ require_node_path.getNodePath();
-	const home = /* @__PURE__ */ require_env_home.getHome();
-	const appdata = /* @__PURE__ */ require_env_windows.getAppdata();
-	const localappdata = /* @__PURE__ */ require_env_windows.getLocalappdata();
-	const xdgDataHome = /* @__PURE__ */ require_env_xdg.getXdgDataHome();
+	const path = require_node_path.getNodePath();
+	const home = require_env_home.getHome();
+	const appdata = require_env_windows.getAppdata();
+	const localappdata = require_env_windows.getLocalappdata();
+	const xdgDataHome = require_env_xdg.getXdgDataHome();
 	/* c8 ignore stop */
 	return findRealBin("pnpm", require_constants_platform.WIN32 ? [
 		appdata ? path.join(appdata, "npm", "pnpm.cmd") : "",
@@ -134,9 +134,9 @@ function findRealPnpm() {
 *   ```
 */
 function findRealYarn() {
-	const path = /* @__PURE__ */ require_node_path.getNodePath();
-	const home = /* @__PURE__ */ require_env_home.getHome();
-	const appdata = /* @__PURE__ */ require_env_windows.getAppdata();
+	const path = require_node_path.getNodePath();
+	const home = require_env_home.getHome();
+	const appdata = require_env_windows.getAppdata();
 	/* c8 ignore stop */
 	return findRealBin("yarn", require_constants_platform.WIN32 ? [
 		appdata ? path.join(appdata, "npm", "yarn.cmd") : "",