@socketsecurity/lib 6.0.8 → 6.0.9

package/dist/bin/resolve.js

@@ -1,8 +1,8 @@
 "use strict";
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_constants_platform = require('../constants/platform.js');
 const require_primordials_string = require('../primordials/string.js');
+const require_constants_platform = require('../constants/platform.js');
 const require_paths_normalize = require('../paths/normalize.js');
 const require_node_fs = require('../node/fs.js');
 const require_node_path = require('../node/path.js');

package/dist/cache/ttl/store.js

@@ -2,9 +2,9 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primordials_error = require('../../primordials/error.js');
+const require_primordials_string = require('../../primordials/string.js');
 const require_primordials_math = require('../../primordials/math.js');
 const require_primordials_map_set = require('../../primordials/map-set.js');
-const require_primordials_string = require('../../primordials/string.js');
 const require_primordials_regexp = require('../../primordials/regexp.js');
 const require_primordials_date = require('../../primordials/date.js');
 const require_primordials_json = require('../../primordials/json.js');

package/dist/compression/brotli.js

@@ -4,8 +4,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_primordials_buffer = require('../primordials/buffer.js');
 const require_primordials_error = require('../primordials/error.js');
-const require_primordials_map_set = require('../primordials/map-set.js');
 const require_primordials_string = require('../primordials/string.js');
+const require_primordials_map_set = require('../primordials/map-set.js');
 const require_fs_safe = require('../fs/safe.js');
 const require_compression__internal = require('./_internal.js');
 let node_fs = require("node:fs");

package/dist/compression/gzip.js

@@ -4,8 +4,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_primordials_buffer = require('../primordials/buffer.js');
 const require_primordials_error = require('../primordials/error.js');
-const require_primordials_map_set = require('../primordials/map-set.js');
 const require_primordials_string = require('../primordials/string.js');
+const require_primordials_map_set = require('../primordials/map-set.js');
 const require_fs_safe = require('../fs/safe.js');
 const require_compression__internal = require('./_internal.js');
 let node_fs = require("node:fs");

package/dist/config/layers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @file Read a layered config — a base config that higher layers may override
+ *   or extend. Generic over the layer directories, the base name, and the file
+ *   extension: `readConfigLayers('vitest', { dirs: ['.config/base',
+ *   '.config/local'] })` reads each `<dir>/vitest.json` in precedence order and
+ *   returns the layers that exist. Callers apply their own merge, because merge
+ *   policy varies (a denylist unions all layers; an allowlist takes the highest
+ *   layer that declares one; an array key concatenates). `mergeConfigArray`
+ *   covers the concat case across any number of layers. No fleet knowledge
+ *   lives here — the fleet-convention `.config/fleet` + `.config/repo` wrapper
+ *   is `fleet/repo-config`'s `resolveRepoConfig`, a thin layer over this
+ *   reader.
+ */
+export interface ReadConfigLayersOptions {
+    dirs: readonly string[];
+    rootDir?: string | undefined;
+    cwd?: string | undefined;
+    ext?: string | undefined;
+}
+/**
+ * Concatenate one array-valued key across all layers — the common merge for a
+ * list that higher layers EXTEND rather than replace (e.g. extra exclude
+ * globs). Layers contribute in precedence order; a non-array value for the key
+ * (or a missing key, or an `undefined` layer) contributes nothing.
+ *
+ * @param layers - The layers from `readConfigLayers` (or any object array).
+ * @param key - The array-valued property to concatenate.
+ *
+ * @returns Each layer's entries in order; `[]` when no layer has the array.
+ */
+export declare function mergeConfigArray<T extends Record<string, unknown>, K extends keyof T>(layers: ReadonlyArray<T | undefined>, key: K): Array<T[K] extends Array<infer E> ? E : never>;
+/**
+ * Read a named config from an ordered list of layer directories.
+ *
+ * For each dir in `dirs`, reads `<rootDir>/<dir>/<name><ext>`; layers that are
+ * absent or unparseable are skipped (never throws — config reads are
+ * best-effort). The returned array preserves `dirs` order (lowest precedence
+ * first), so the last element is the highest-precedence layer present.
+ *
+ * @example
+ *   ;```typescript
+ *   const layers = readConfigLayers<VitestConfig>('vitest', {
+ *     dirs: ['.config/base', '.config/team', '.config/local'],
+ *   })
+ *   // layers === every one of those that existed, in that order
+ *   ```
+ *
+ * @param name - Base name of the config file (no directory, no extension).
+ * @param options - Layer dirs + resolution options.
+ *
+ * @returns Parsed layers in precedence order; empty when none exist.
+ */
+export declare function readConfigLayers<T = unknown>(name: string, options: ReadConfigLayersOptions): T[];

package/dist/config/layers.js

@@ -0,0 +1,83 @@
+"use strict";
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_node_path = require('../node/path.js');
+const require_fs_read_json = require('../fs/read-json.js');
+const require_primordials_process = require('../primordials/process.js');
+const require_git_repo = require('../git/repo.js');
+
+//#region src/config/layers.ts
+/**
+* @file Read a layered config — a base config that higher layers may override
+*   or extend. Generic over the layer directories, the base name, and the file
+*   extension: `readConfigLayers('vitest', { dirs: ['.config/base',
+*   '.config/local'] })` reads each `<dir>/vitest.json` in precedence order and
+*   returns the layers that exist. Callers apply their own merge, because merge
+*   policy varies (a denylist unions all layers; an allowlist takes the highest
+*   layer that declares one; an array key concatenates). `mergeConfigArray`
+*   covers the concat case across any number of layers. No fleet knowledge
+*   lives here — the fleet-convention `.config/fleet` + `.config/repo` wrapper
+*   is `fleet/repo-config`'s `resolveRepoConfig`, a thin layer over this
+*   reader.
+*/
+/**
+* Concatenate one array-valued key across all layers — the common merge for a
+* list that higher layers EXTEND rather than replace (e.g. extra exclude
+* globs). Layers contribute in precedence order; a non-array value for the key
+* (or a missing key, or an `undefined` layer) contributes nothing.
+*
+* @param layers - The layers from `readConfigLayers` (or any object array).
+* @param key - The array-valued property to concatenate.
+*
+* @returns Each layer's entries in order; `[]` when no layer has the array.
+*/
+function mergeConfigArray(layers, key) {
+	const out = [];
+	for (let i = 0, { length } = layers; i < length; i += 1) {
+		const value = layers[i]?.[key];
+		if (Array.isArray(value)) out.push(...value);
+	}
+	return out;
+}
+/**
+* Read a named config from an ordered list of layer directories.
+*
+* For each dir in `dirs`, reads `<rootDir>/<dir>/<name><ext>`; layers that are
+* absent or unparseable are skipped (never throws — config reads are
+* best-effort). The returned array preserves `dirs` order (lowest precedence
+* first), so the last element is the highest-precedence layer present.
+*
+* @example
+*   ;```typescript
+*   const layers = readConfigLayers<VitestConfig>('vitest', {
+*     dirs: ['.config/base', '.config/team', '.config/local'],
+*   })
+*   // layers === every one of those that existed, in that order
+*   ```
+*
+* @param name - Base name of the config file (no directory, no extension).
+* @param options - Layer dirs + resolution options.
+*
+* @returns Parsed layers in precedence order; empty when none exist.
+*/
+function readConfigLayers(name, options) {
+	const opts = {
+		__proto__: null,
+		...options
+	};
+	const path = require_node_path.getNodePath();
+	const cwd = opts.cwd ?? require_primordials_process.processCwd();
+	const rootDir = opts.rootDir ?? require_git_repo.findGitRoot(cwd);
+	const file = `${name}${opts.ext ?? ".json"}`;
+	const layers = [];
+	const { dirs } = opts;
+	for (let i = 0, { length } = dirs; i < length; i += 1) {
+		const value = require_fs_read_json.readJsonSync(path.join(rootDir, dirs[i], file), { throws: false });
+		if (value !== void 0) layers.push(value);
+	}
+	return layers;
+}
+
+//#endregion
+exports.mergeConfigArray = mergeConfigArray;
+exports.readConfigLayers = readConfigLayers;

package/dist/constants/socket.js

@@ -35,7 +35,7 @@ const SOCKET_DIR = {
 	wheelhouse: `${"_"}wheelhouse`
 };
 const SOCKET_LIB_NAME = "@socketsecurity/lib";
-const SOCKET_LIB_VERSION = "6.0.8";
+const SOCKET_LIB_VERSION = "6.0.9";
 const SOCKET_IPC_HANDSHAKE = "SOCKET_IPC_HANDSHAKE";
 const CACHE_SOCKET_API_DIR = "socket-api";
 const REGISTRY = "registry";

package/dist/debug/caller-info.js

@@ -1,8 +1,8 @@
 "use strict";
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_objects_predicates = require('../objects/predicates.js');
 const require_primordials_string = require('../primordials/string.js');
+const require_objects_predicates = require('../objects/predicates.js');
 
 //#region src/debug/caller-info.ts
 /**

package/dist/dlx/binary-cache.js

@@ -2,8 +2,8 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
-const require_objects_predicates = require('../objects/predicates.js');
 const require_primordials_string = require('../primordials/string.js');
+const require_objects_predicates = require('../objects/predicates.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');

package/dist/dlx/binary-resolution.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_primordials_error = require('../primordials/error.js');
-const require_constants_platform = require('../constants/platform.js');
 const require_primordials_object = require('../primordials/object.js');
+const require_constants_platform = require('../constants/platform.js');
 const require_paths_normalize = require('../paths/normalize.js');
 const require_node_fs = require('../node/fs.js');
 const require_node_path = require('../node/path.js');

package/dist/dlx/firewall.js

@@ -2,8 +2,8 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primordials_error = require('../primordials/error.js');
-const require_primordials_map_set = require('../primordials/map-set.js');
 const require_primordials_string = require('../primordials/string.js');
+const require_primordials_map_set = require('../primordials/map-set.js');
 const require_primordials_promise = require('../primordials/promise.js');
 const require_http_request_user_agent = require('../http-request/user-agent.js');
 const require_http_request_node = require('../http-request/node.js');

package/dist/dlx/lockfile.js

@@ -2,8 +2,8 @@
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
-const require_integrity = require('../integrity.js');
 const require_primordials_string = require('../primordials/string.js');
+const require_integrity = require('../integrity.js');
 const require_node_fs = require('../node/fs.js');
 const require_node_path = require('../node/path.js');
 const require_primordials_date = require('../primordials/date.js');

package/dist/eco/npm/npm/parse-lockfile.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primordials_error = require('../../../primordials/error.js');
 const require_primordials_object = require('../../../primordials/object.js');
-const require_primordials_map_set = require('../../../primordials/map-set.js');
 const require_primordials_string = require('../../../primordials/string.js');
+const require_primordials_map_set = require('../../../primordials/map-set.js');
 const require_primordials_array = require('../../../primordials/array.js');
 const require_primordials_json = require('../../../primordials/json.js');
 const require_errors_message = require('../../../errors/message.js');

package/dist/eco/npm/yarnpkg/yarn/parse-lockfile.js

@@ -1,9 +1,9 @@
 "use strict";
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_primordials_math = require('../../../../primordials/math.js');
 const require_primordials_object = require('../../../../primordials/object.js');
 const require_primordials_string = require('../../../../primordials/string.js');
+const require_primordials_math = require('../../../../primordials/math.js');
 const require_primordials_array = require('../../../../primordials/array.js');
 const require_smol_manifest = require('../../../../smol/manifest.js');
 const require_eco_npm_yarnpkg_yarn_parse_yarn_descriptor = require('./parse-yarn-descriptor.js');

package/dist/env/rewire.d.ts

@@ -8,7 +8,7 @@
  *   - Compatible with vi.stubEnv() - reads from process.env as final fallback
  *   - Thread-safe for concurrent test execution
  */
-import type * as asyncHooksModule from 'node:async_hooks';
+import { getNodeAsyncHooks } from '../node/async-hooks';
 export type EnvOverrides = Map<string, string | undefined>;
 /**
  * Clear a specific environment variable override.
@@ -25,11 +25,13 @@ export type EnvOverrides = Map<string, string | undefined>;
  */
 export declare function clearEnv(key: string): void;
 /**
- * Lazily load the async_hooks module to avoid Webpack errors.
+ * Lazily load the async_hooks module. Aliases the canonical `node/async-hooks`
+ * accessor (single owner of the bundler-safe require); kept as an export so
+ * this module's surface is unchanged.
  *
  * @private
  */
-export declare function getAsyncHooks(): typeof asyncHooksModule;
+export declare const getAsyncHooks: typeof getNodeAsyncHooks;
 /**
  * Get an environment variable value, checking overrides first.
  *

package/dist/env/rewire.js

@@ -5,6 +5,7 @@ const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_primordials_object = require('../primordials/object.js');
 const require_objects_predicates = require('../objects/predicates.js');
 const require_env_boolean = require('./boolean.js');
+const require_node_async_hooks = require('../node/async-hooks.js');
 const require_primordials_map_set = require('../primordials/map-set.js');
 let node_process = require("node:process");
 node_process = require_runtime.__toESM(node_process);
@@ -20,8 +21,7 @@ node_process = require_runtime.__toESM(node_process);
 *   - Compatible with vi.stubEnv() - reads from process.env as final fallback
 *   - Thread-safe for concurrent test execution
 */
-let asyncHooks;
-const { AsyncLocalStorage } = getAsyncHooks();
+const { AsyncLocalStorage } = require_node_async_hooks.getNodeAsyncHooks();
 const isolatedOverridesStorage = new AsyncLocalStorage();
 const sharedOverridesSymbol = Symbol.for("@socketsecurity/lib/env/rewire/test-overrides");
 const globalThisRef = globalThis;
@@ -44,14 +44,13 @@ function clearEnv(key) {
 	sharedOverrides?.delete(key);
 }
 /**
-* Lazily load the async_hooks module to avoid Webpack errors.
+* Lazily load the async_hooks module. Aliases the canonical `node/async-hooks`
+* accessor (single owner of the bundler-safe require); kept as an export so
+* this module's surface is unchanged.
 *
 * @private
 */
-function getAsyncHooks() {
-	if (asyncHooks === void 0) asyncHooks = /*@__PURE__*/ require("node:async_hooks");
-	return asyncHooks;
-}
+const getAsyncHooks = require_node_async_hooks.getNodeAsyncHooks;
 /**
 * Get an environment variable value, checking overrides first.
 *

package/dist/env/xdg.d.ts

@@ -47,3 +47,20 @@ export declare function getXdgConfigHome(): string | undefined;
  * @returns The XDG data directory path, or `undefined` if not set
  */
 export declare function getXdgDataHome(): string | undefined;
+/**
+ * XDG_RUNTIME_DIR environment variable. XDG Base Directory specification
+ * runtime directory — the home for ephemeral, owner-only runtime objects
+ * (daemon sockets, locks). Set by systemd to `/run/user/<uid>`; absent on
+ * macOS and many non-systemd setups, so callers must provide a fallback.
+ *
+ * @example
+ *   ;```typescript
+ *   import { getXdgRuntimeDir } from '@socketsecurity/lib/env/xdg'
+ *
+ *   const runtimeDir = getXdgRuntimeDir()
+ *   // e.g. '/run/user/1000' or undefined
+ *   ```
+ *
+ * @returns The XDG runtime directory path, or `undefined` if not set
+ */
+export declare function getXdgRuntimeDir(): string | undefined;

package/dist/env/xdg.js

@@ -59,8 +59,28 @@ function getXdgConfigHome() {
 function getXdgDataHome() {
 	return require_env_rewire.getEnvValue("XDG_DATA_HOME");
 }
+/**
+* XDG_RUNTIME_DIR environment variable. XDG Base Directory specification
+* runtime directory — the home for ephemeral, owner-only runtime objects
+* (daemon sockets, locks). Set by systemd to `/run/user/<uid>`; absent on
+* macOS and many non-systemd setups, so callers must provide a fallback.
+*
+* @example
+*   ;```typescript
+*   import { getXdgRuntimeDir } from '@socketsecurity/lib/env/xdg'
+*
+*   const runtimeDir = getXdgRuntimeDir()
+*   // e.g. '/run/user/1000' or undefined
+*   ```
+*
+* @returns The XDG runtime directory path, or `undefined` if not set
+*/
+function getXdgRuntimeDir() {
+	return require_env_rewire.getEnvValue("XDG_RUNTIME_DIR");
+}
 
 //#endregion
 exports.getXdgCacheHome = getXdgCacheHome;
 exports.getXdgConfigHome = getXdgConfigHome;
-exports.getXdgDataHome = getXdgDataHome;
+exports.getXdgDataHome = getXdgDataHome;
+exports.getXdgRuntimeDir = getXdgRuntimeDir;

package/dist/errors/stack.js

@@ -1,7 +1,6 @@
 "use strict";
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_errors_predicates = require('./predicates.js');
 let src_external_pony_cause = require("../external/pony-cause");
 
 //#region src/errors/stack.ts
@@ -19,7 +18,7 @@ let src_external_pony_cause = require("../external/pony-cause");
 * errorStack(e) })` safely.
 */
 function errorStack(value) {
-	if (require_errors_predicates.isError(value)) return (0, src_external_pony_cause.stackWithCauses)(value);
+	if (isError(value)) return (0, src_external_pony_cause.stackWithCauses)(value);
 }
 
 //#endregion