chore(release): bump version to 2.9.0

Added Socket.dev URL constants and enhanced error messages across library.

Author: jdalton

CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.9.0](https://github.com/SocketDev/socket-lib/releases/tag/v2.9.0) - 2025-10-30
+
+### Added
+
+- **Socket.dev URL constants**: Added centralized URL constants for Socket.dev services
+  - `SOCKET_WEBSITE_URL`: Main Socket.dev website
+  - `SOCKET_CONTACT_URL`: Contact page
+  - `SOCKET_DASHBOARD_URL`: Dashboard homepage
+  - `SOCKET_API_TOKENS_URL`: API tokens settings page
+  - `SOCKET_PRICING_URL`: Pricing information
+  - `SOCKET_STATUS_URL`: Service status page
+  - `SOCKET_DOCS_URL`: Documentation site
+  - Available via `@socketsecurity/lib/constants/socket`
+
+### Changed
+
+- **Enhanced error messages across library**: Comprehensive audit and improvement of error handling
+  - Added actionable error messages with resolution steps throughout modules
+  - Improved file system operation errors (permissions, read-only filesystems, path issues)
+  - Enhanced DLX error messages with clear troubleshooting guidance
+  - Better error context in process locking, binary downloads, and package operations
+  - Consistent error formatting with helpful user guidance
+- **Consolidated process locking**: Standardized on directory-based lock format across all modules
+  - All locking operations now use `process-lock` module exclusively
+  - Lock directories provide atomic guarantees across all filesystems including NFS
+  - Consistent mtime-based stale detection with 5-second timeout (aligned with npm npx)
+  - Automatic cleanup on process exit with proper signal handling
+
 ## [2.8.4](https://github.com/SocketDev/socket-lib/releases/tag/v2.8.4) - 2025-10-30
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "2.8.4",
+  "version": "2.9.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
   "keywords": [

test/constants/socket.test.ts

@@ -9,13 +9,18 @@ import {
   REGISTRY,
   REGISTRY_SCOPE_DELIMITER,
   SOCKET_API_BASE_URL,
+  SOCKET_API_TOKENS_URL,
   SOCKET_APP_PREFIX,
   SOCKET_CLI_APP_NAME,
+  SOCKET_CONTACT_URL,
+  SOCKET_DASHBOARD_URL,
   SOCKET_DLX_APP_NAME,
+  SOCKET_DOCS_URL,
   SOCKET_FIREWALL_APP_NAME,
   SOCKET_GITHUB_ORG,
   SOCKET_IPC_HANDSHAKE,
   SOCKET_OVERRIDE_SCOPE,
+  SOCKET_PRICING_URL,
   SOCKET_PUBLIC_API_KEY,
   SOCKET_PUBLIC_API_TOKEN,
   SOCKET_REGISTRY_APP_NAME,
@@ -24,6 +29,8 @@ import {
   SOCKET_REGISTRY_REPO_NAME,
   SOCKET_REGISTRY_SCOPE,
   SOCKET_SECURITY_SCOPE,
+  SOCKET_STATUS_URL,
+  SOCKET_WEBSITE_URL,
 } from '@socketsecurity/lib/constants/socket'
 
 describe('constants/socket', () => {
@@ -75,6 +82,94 @@ describe('constants/socket', () => {
     })
   })
 
+  describe('Socket.dev URLs', () => {
+    it('should export SOCKET_WEBSITE_URL', () => {
+      expect(SOCKET_WEBSITE_URL).toBe('https://socket.dev')
+    })
+
+    it('should export SOCKET_CONTACT_URL', () => {
+      expect(SOCKET_CONTACT_URL).toBe('https://socket.dev/contact')
+    })
+
+    it('should export SOCKET_DASHBOARD_URL', () => {
+      expect(SOCKET_DASHBOARD_URL).toBe('https://socket.dev/dashboard')
+    })
+
+    it('should export SOCKET_API_TOKENS_URL', () => {
+      expect(SOCKET_API_TOKENS_URL).toBe(
+        'https://socket.dev/dashboard/settings/api-tokens',
+      )
+    })
+
+    it('should export SOCKET_PRICING_URL', () => {
+      expect(SOCKET_PRICING_URL).toBe('https://socket.dev/pricing')
+    })
+
+    it('should export SOCKET_STATUS_URL', () => {
+      expect(SOCKET_STATUS_URL).toBe('https://status.socket.dev')
+    })
+
+    it('should export SOCKET_DOCS_URL', () => {
+      expect(SOCKET_DOCS_URL).toBe('https://docs.socket.dev')
+    })
+
+    it('should all be valid HTTPS URLs', () => {
+      const urls = [
+        SOCKET_WEBSITE_URL,
+        SOCKET_CONTACT_URL,
+        SOCKET_DASHBOARD_URL,
+        SOCKET_API_TOKENS_URL,
+        SOCKET_PRICING_URL,
+        SOCKET_STATUS_URL,
+        SOCKET_DOCS_URL,
+      ]
+      urls.forEach(url => {
+        expect(url).toMatch(/^https:\/\//)
+        expect(() => new URL(url)).not.toThrow()
+      })
+    })
+
+    it('should all contain socket.dev domain', () => {
+      const urls = [
+        SOCKET_WEBSITE_URL,
+        SOCKET_CONTACT_URL,
+        SOCKET_DASHBOARD_URL,
+        SOCKET_API_TOKENS_URL,
+        SOCKET_PRICING_URL,
+        SOCKET_STATUS_URL,
+        SOCKET_DOCS_URL,
+      ]
+      urls.forEach(url => {
+        expect(url).toContain('socket.dev')
+      })
+    })
+
+    it('should not have trailing slashes', () => {
+      const urls = [
+        SOCKET_WEBSITE_URL,
+        SOCKET_CONTACT_URL,
+        SOCKET_DASHBOARD_URL,
+        SOCKET_API_TOKENS_URL,
+        SOCKET_PRICING_URL,
+        SOCKET_STATUS_URL,
+        SOCKET_DOCS_URL,
+      ]
+      urls.forEach(url => {
+        expect(url.endsWith('/')).toBe(false)
+      })
+    })
+
+    it('should support URL path construction', () => {
+      const orgDashboard = `${SOCKET_DASHBOARD_URL}/org/myorg`
+      expect(orgDashboard).toBe('https://socket.dev/dashboard/org/myorg')
+    })
+
+    it('should support documentation path construction', () => {
+      const guidePath = `${SOCKET_DOCS_URL}/docs/getting-started`
+      expect(guidePath).toBe('https://docs.socket.dev/docs/getting-started')
+    })
+  })
+
   describe('Socket.dev scopes', () => {
     it('should export SOCKET_REGISTRY_SCOPE', () => {
       expect(SOCKET_REGISTRY_SCOPE).toBe('@socketregistry')