fix(paths): add missing getPathValue caching to getSocketDlxDir

- Refactored getSocketDlxDir() to use getPathValue() for performance
- Adds test override support via setPath('socket-dlx-dir', ...)
- Fixes pattern inconsistency with getSocketUserDir() and getSocketCacacheDir()
- Updated test to call resetPaths() after env var override
- Added resetPaths() calls to mockHomeDir() helper for cache invalidation
- Updated documentation to reflect caching and test override support

Author: jdalton

package.json

@@ -714,7 +714,7 @@
     "@socketregistry/is-unicode-supported": "1.0.5",
     "@socketregistry/packageurl-js": "1.3.5",
     "@socketregistry/yocto-spinner": "1.0.25",
-    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@5.1.0",
+    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@5.1.1",
     "@types/node": "24.9.2",
     "@typescript/native-preview": "7.0.0-dev.20250920.1",
     "@vitest/coverage-v8": "4.0.3",

pnpm-lock.yaml

@@ -114,21 +114,28 @@ export function getSocketCacacheDir(): string {
 
 /**
  * Get the Socket DLX directory (~/.socket/_dlx).
- * Can be overridden with environment variables.
+ * Can be overridden with SOCKET_DLX_DIR environment variable or via setPath() for testing.
+ * Result is cached via getPathValue for performance.
  *
  * Priority order:
- *   1. SOCKET_DLX_DIR - Full override of DLX cache directory
- *   2. SOCKET_HOME/_dlx - Base directory override (inherits from getSocketUserDir)
- *   3. Default: $HOME/.socket/_dlx
- *   4. Fallback: /tmp/.socket/_dlx (Unix) or %TEMP%\.socket\_dlx (Windows)
+ *   1. Test override via setPath('socket-dlx-dir', ...)
+ *   2. SOCKET_DLX_DIR - Full override of DLX cache directory
+ *   3. SOCKET_HOME/_dlx - Base directory override (inherits from getSocketUserDir)
+ *   4. Default: $HOME/.socket/_dlx
+ *   5. Fallback: /tmp/.socket/_dlx (Unix) or %TEMP%\.socket\_dlx (Windows)
  */
 export function getSocketDlxDir(): string {
-  if (getSocketDlxDirEnv()) {
-    return normalizePath(getSocketDlxDirEnv() as string)
-  }
-  return normalizePath(
-    path.join(getSocketUserDir(), `${SOCKET_APP_PREFIX}${SOCKET_DLX_APP_NAME}`),
-  )
+  return getPathValue('socket-dlx-dir', () => {
+    if (getSocketDlxDirEnv()) {
+      return normalizePath(getSocketDlxDirEnv() as string)
+    }
+    return normalizePath(
+      path.join(
+        getSocketUserDir(),
+        `${SOCKET_APP_PREFIX}${SOCKET_DLX_APP_NAME}`,
+      ),
+    )
+  })
 }
 
 /**

src/paths/socket.ts

@@ -206,6 +206,7 @@ describe('paths/socket', () => {
 
     it('should be overridable via env var', () => {
       setEnv('SOCKET_DLX_DIR', '/custom/dlx')
+      resetPaths()
       const result = getSocketDlxDir()
       expect(result).toBe('/custom/dlx')
     })

test/unit/paths/socket.test.ts

@@ -8,6 +8,7 @@ import os from 'node:os'
 import path from 'node:path'
 
 import { clearEnv, setEnv } from '@socketsecurity/lib/env/rewire'
+import { resetPaths } from '@socketsecurity/lib/paths/rewire'
 
 /**
  * Mock the home directory for cross-platform testing.
@@ -40,6 +41,9 @@ export function mockHomeDir(homeDir: string): () => void {
     process.env['USERPROFILE'] = homeDir
   }
 
+  // Reset path cache after env changes.
+  resetPaths()
+
   // Return restore function.
   return () => {
     clearEnv('HOME')
@@ -61,6 +65,9 @@ export function mockHomeDir(homeDir: string): () => void {
     } else {
       process.env['USERPROFILE'] = originalEnv.USERPROFILE
     }
+
+    // Reset path cache after restoring env.
+    resetPaths()
   }
 }