chore(release): Release v5.2.0

Author: jdalton

CHANGELOG.md

@@ -5,6 +5,21 @@ 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).
 
+## [5.2.0](https://github.com/SocketDev/socket-lib/releases/tag/v5.2.0) - 2026-01-06
+
+### Added
+
+- **releases**: Added GitHub release download utilities for cross-project use
+  - Added `downloadGitHubRelease()` for downloading releases from any GitHub repository
+  - Added `downloadSocketBtmRelease()` specialized wrapper for socket-btm releases
+  - Features version caching with `.version` files to avoid redundant downloads
+  - Supports cross-platform binary downloads (darwin, linux, win32) with automatic platform/arch detection
+  - Includes Linux musl/glibc support with musl as default for broader compatibility
+  - Automatically removes macOS quarantine attributes from downloaded binaries
+  - Supports generic asset downloads (WASM files, models, etc.)
+  - API inspired by industry tools: `brew`, `cargo`, `gh` for intuitive usage
+  - Package exports: `@socketsecurity/lib/releases/github` and `@socketsecurity/lib/releases/socket-btm`
+
 ## [5.1.4](https://github.com/SocketDev/socket-lib/releases/tag/v5.1.4) - 2025-12-30
 
 ### Fixed

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "5.1.4",
+  "version": "5.2.0",
   "packageManager": "pnpm@10.26.2",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
@@ -523,6 +523,14 @@
       "types": "./dist/regexps.d.ts",
       "default": "./dist/regexps.js"
     },
+    "./releases/github": {
+      "types": "./dist/releases/github.d.ts",
+      "default": "./dist/releases/github.js"
+    },
+    "./releases/socket-btm": {
+      "types": "./dist/releases/socket-btm.d.ts",
+      "default": "./dist/releases/socket-btm.js"
+    },
     "./sea": {
       "types": "./dist/sea.d.ts",
       "default": "./dist/sea.js"

test/integration/fs.test.mts

@@ -20,7 +20,7 @@ import {
   writeJson,
 } from '@socketsecurity/lib/fs'
 import { describe, expect, it } from 'vitest'
-import { runWithTempDir } from '../unit/utils/temp-file-helper.mjs'
+import { runWithTempDir } from '../unit/utils/temp-file-helper'
 
 describe('fs integration', () => {
   describe('JSON file operations', () => {

test/integration/git.test.mts

@@ -15,7 +15,7 @@ import path from 'node:path'
 import { findGitRoot } from '@socketsecurity/lib/git'
 import { spawn } from '@socketsecurity/lib/spawn'
 import { describe, expect, it } from 'vitest'
-import { runWithTempDir } from '../unit/utils/temp-file-helper.mjs'
+import { runWithTempDir } from '../unit/utils/temp-file-helper'
 
 describe('git integration', () => {
   describe('repository detection', () => {

test/unit/bin.test.mts

@@ -25,7 +25,7 @@ import {
   whichRealSync,
 } from '@socketsecurity/lib/bin'
 import { describe, expect, it } from 'vitest'
-import { runWithTempDir } from './utils/temp-file-helper.mjs'
+import { runWithTempDir } from './utils/temp-file-helper'
 
 describe('bin', () => {
   describe('isShadowBinPath', () => {

test/unit/dlx/binary.test.mts

@@ -24,7 +24,7 @@ import {
   listDlxCache,
 } from '@socketsecurity/lib/dlx/binary'
 import { afterAll, beforeAll, describe, expect, it } from 'vitest'
-import { mockHomeDir, runWithTempDir } from '../utils/temp-file-helper.mjs'
+import { mockHomeDir, runWithTempDir } from '../utils/temp-file-helper'
 
 // Test server setup
 let httpServer: http.Server

test/unit/dlx/package.test.mts

@@ -19,7 +19,7 @@ import type {
   DlxPackageOptions,
   DlxPackageResult,
 } from '@socketsecurity/lib/dlx/package'
-import { runWithTempDir } from '../utils/temp-file-helper.mjs'
+import { runWithTempDir } from '../utils/temp-file-helper'
 
 describe('dlx-package', () => {
   describe('generatePackageCacheKey', () => {

test/unit/fs-additional.test.mts

@@ -41,7 +41,7 @@ import {
   writeJsonSync,
 } from '@socketsecurity/lib/fs'
 import { describe, expect, it } from 'vitest'
-import { runWithTempDir } from './utils/temp-file-helper.mjs'
+import { runWithTempDir } from './utils/temp-file-helper'
 
 describe('fs - Additional Coverage', () => {
   describe('findUp edge cases', () => {

test/unit/fs.test.mts

@@ -47,7 +47,7 @@ import {
   writeJsonSync,
 } from '@socketsecurity/lib/fs'
 import { describe, expect, it } from 'vitest'
-import { runWithTempDir } from './utils/temp-file-helper.mjs'
+import { runWithTempDir } from './utils/temp-file-helper'
 
 describe('fs', () => {
   describe('findUp', () => {

test/unit/git-extended.test.mts

@@ -30,7 +30,7 @@ import {
 import { normalizePath } from '@socketsecurity/lib/paths/normalize'
 import { spawnSync } from '@socketsecurity/lib/spawn'
 import { describe, expect, it } from 'vitest'
-import { runWithTempDir } from './utils/temp-file-helper.mjs'
+import { runWithTempDir } from './utils/temp-file-helper'
 
 describe('git extended tests', () => {
   const projectRoot = normalizePath(process.cwd())