test: add comprehensive unit tests for enhanced GitHub release methods with glob pattern support

Author: jdalton

test/unit/releases-github.test.mts

@@ -2,15 +2,57 @@
  * @fileoverview Unit tests for GitHub release download utilities.
  */
 
-import { describe, expect, it } from 'vitest'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 
 import picomatch from 'picomatch'
 
 import {
+  downloadReleaseAsset,
   getAuthHeaders,
+  getLatestRelease,
+  getReleaseAssetUrl,
   SOCKET_BTM_REPO,
 } from '@socketsecurity/lib/releases/github'
 
+import type { HttpResponse } from '@socketsecurity/lib/http-request'
+import { httpDownload, httpRequest } from '@socketsecurity/lib/http-request'
+
+// Mock httpRequest and httpDownload modules.
+vi.mock('@socketsecurity/lib/http-request')
+
+/**
+ * Create a mock HttpResponse object for testing.
+ *
+ * @param body - Response body as Buffer
+ * @param ok - Whether the request was successful
+ * @param status - HTTP status code
+ * @returns Complete mock HttpResponse object
+ */
+function createMockHttpResponse(
+  body: Buffer,
+  ok: boolean,
+  status: number,
+): HttpResponse {
+  return {
+    arrayBuffer: () => {
+      const slice = body.buffer.slice(
+        body.byteOffset,
+        body.byteOffset + body.byteLength,
+      )
+      return slice as ArrayBuffer
+    },
+    body,
+    headers: {},
+    json<T = unknown>(): T {
+      return JSON.parse(body.toString('utf8')) as T
+    },
+    ok,
+    status,
+    statusText: ok ? 'OK' : 'Error',
+    text: () => body.toString('utf8'),
+  }
+}
+
 describe('releases/github', () => {
   describe('SOCKET_BTM_REPO', () => {
     it('should export socket-btm repository config', () => {
@@ -178,4 +220,289 @@ describe('releases/github', () => {
       expect(isMatch('YOGA-SYNC-abc.MJS')).toBe(false)
     })
   })
+
+  describe('getLatestRelease', () => {
+    const mockReleases = [
+      {
+        assets: [
+          { name: 'yoga-sync-20260107-abc123.mjs' },
+          { name: 'yoga-layout-20260107-abc123.mjs' },
+        ],
+        tag_name: 'yoga-layout-20260107-abc123',
+      },
+      {
+        assets: [
+          { name: 'models-20260106-def456.tar.gz' },
+          { name: 'models-embeddings-20260106-def456.bin' },
+        ],
+        tag_name: 'models-20260106-def456',
+      },
+      {
+        assets: [{ name: 'node-darwin-arm64' }, { name: 'node-linux-x64' }],
+        tag_name: 'node-smol-20260105-ghi789',
+      },
+    ]
+
+    beforeEach(() => {
+      vi.mocked(httpRequest).mockResolvedValue(
+        createMockHttpResponse(
+          Buffer.from(JSON.stringify(mockReleases)),
+          true,
+          200,
+        ),
+      )
+    })
+
+    afterEach(() => {
+      vi.clearAllMocks()
+    })
+
+    it('should find latest release by prefix without asset pattern', async () => {
+      const tag = await getLatestRelease('yoga-layout-', SOCKET_BTM_REPO, {
+        quiet: true,
+      })
+      expect(tag).toBe('yoga-layout-20260107-abc123')
+    })
+
+    it('should find latest release by prefix with matching asset pattern', async () => {
+      const tag = await getLatestRelease('yoga-layout-', SOCKET_BTM_REPO, {
+        assetPattern: 'yoga-sync-*.mjs',
+        quiet: true,
+      })
+      expect(tag).toBe('yoga-layout-20260107-abc123')
+    })
+
+    it('should skip release without matching asset when pattern provided', async () => {
+      const tag = await getLatestRelease('node-smol-', SOCKET_BTM_REPO, {
+        assetPattern: '*.tar.gz',
+        quiet: true,
+      })
+      expect(tag).toBeNull()
+    })
+
+    it('should match asset with brace expansion pattern', async () => {
+      const tag = await getLatestRelease('models-', SOCKET_BTM_REPO, {
+        assetPattern: 'models-{embeddings,data}-*.{bin,dat}',
+        quiet: true,
+      })
+      expect(tag).toBe('models-20260106-def456')
+    })
+
+    it('should match asset with RegExp pattern', async () => {
+      const tag = await getLatestRelease('models-', SOCKET_BTM_REPO, {
+        assetPattern: /^models-\d{8}-.+\.tar\.gz$/,
+        quiet: true,
+      })
+      expect(tag).toBe('models-20260106-def456')
+    })
+
+    it('should return null when no releases match prefix', async () => {
+      const tag = await getLatestRelease('nonexistent-', SOCKET_BTM_REPO, {
+        quiet: true,
+      })
+      expect(tag).toBeNull()
+    })
+  })
+
+  describe('getReleaseAssetUrl', () => {
+    const mockRelease = {
+      assets: [
+        {
+          browser_download_url:
+            'https://github.com/test/repo/releases/download/v1.0.0/yoga-sync-20260107-abc123.mjs',
+          name: 'yoga-sync-20260107-abc123.mjs',
+        },
+        {
+          browser_download_url:
+            'https://github.com/test/repo/releases/download/v1.0.0/yoga-layout-20260107-abc123.mjs',
+          name: 'yoga-layout-20260107-abc123.mjs',
+        },
+        {
+          browser_download_url:
+            'https://github.com/test/repo/releases/download/v1.0.0/models-data.tar.gz',
+          name: 'models-data.tar.gz',
+        },
+      ],
+      tag_name: 'v1.0.0',
+    }
+
+    beforeEach(() => {
+      vi.mocked(httpRequest).mockResolvedValue(
+        createMockHttpResponse(
+          Buffer.from(JSON.stringify(mockRelease)),
+          true,
+          200,
+        ),
+      )
+    })
+
+    afterEach(() => {
+      vi.clearAllMocks()
+    })
+
+    it('should get asset URL with exact name', async () => {
+      const url = await getReleaseAssetUrl(
+        'v1.0.0',
+        'yoga-sync-20260107-abc123.mjs',
+        SOCKET_BTM_REPO,
+        { quiet: true },
+      )
+      expect(url).toBe(
+        'https://github.com/test/repo/releases/download/v1.0.0/yoga-sync-20260107-abc123.mjs',
+      )
+    })
+
+    it('should get asset URL with wildcard pattern', async () => {
+      const url = await getReleaseAssetUrl(
+        'v1.0.0',
+        'yoga-sync-*.mjs',
+        SOCKET_BTM_REPO,
+        { quiet: true },
+      )
+      expect(url).toBe(
+        'https://github.com/test/repo/releases/download/v1.0.0/yoga-sync-20260107-abc123.mjs',
+      )
+    })
+
+    it('should get asset URL with brace expansion', async () => {
+      const url = await getReleaseAssetUrl(
+        'v1.0.0',
+        'yoga-{sync,layout}-*.mjs',
+        SOCKET_BTM_REPO,
+        { quiet: true },
+      )
+      expect(url).toBe(
+        'https://github.com/test/repo/releases/download/v1.0.0/yoga-sync-20260107-abc123.mjs',
+      )
+    })
+
+    it('should get asset URL with RegExp pattern', async () => {
+      const url = await getReleaseAssetUrl(
+        'v1.0.0',
+        /^models-.+\.tar\.gz$/,
+        SOCKET_BTM_REPO,
+        { quiet: true },
+      )
+      expect(url).toBe(
+        'https://github.com/test/repo/releases/download/v1.0.0/models-data.tar.gz',
+      )
+    })
+
+    it('should get asset URL with prefix/suffix object pattern', async () => {
+      const url = await getReleaseAssetUrl(
+        'v1.0.0',
+        { prefix: 'models-', suffix: '.tar.gz' },
+        SOCKET_BTM_REPO,
+        { quiet: true },
+      )
+      expect(url).toBe(
+        'https://github.com/test/repo/releases/download/v1.0.0/models-data.tar.gz',
+      )
+    })
+
+    it('should throw error when pattern does not match any asset', async () => {
+      await expect(
+        getReleaseAssetUrl('v1.0.0', 'nonexistent-*.xyz', SOCKET_BTM_REPO, {
+          quiet: true,
+        }),
+      ).rejects.toThrow('Asset nonexistent-*.xyz not found in release v1.0.0')
+    }, 40_000)
+  })
+
+  describe('downloadReleaseAsset', () => {
+    const mockRelease = {
+      assets: [
+        {
+          browser_download_url:
+            'https://github.com/test/repo/releases/download/v1.0.0/yoga-sync-abc.mjs',
+          name: 'yoga-sync-abc.mjs',
+        },
+        {
+          browser_download_url:
+            'https://github.com/test/repo/releases/download/v1.0.0/models-data.tar.gz',
+          name: 'models-data.tar.gz',
+        },
+      ],
+      tag_name: 'v1.0.0',
+    }
+
+    beforeEach(() => {
+      vi.mocked(httpRequest).mockResolvedValue(
+        createMockHttpResponse(
+          Buffer.from(JSON.stringify(mockRelease)),
+          true,
+          200,
+        ),
+      )
+      vi.mocked(httpDownload).mockResolvedValue(undefined)
+    })
+
+    afterEach(() => {
+      vi.clearAllMocks()
+    })
+
+    it('should download asset with exact name', async () => {
+      await downloadReleaseAsset(
+        'v1.0.0',
+        'yoga-sync-abc.mjs',
+        '/tmp/output.mjs',
+        SOCKET_BTM_REPO,
+        { quiet: true },
+      )
+
+      expect(httpDownload).toHaveBeenCalledWith(
+        'https://github.com/test/repo/releases/download/v1.0.0/yoga-sync-abc.mjs',
+        '/tmp/output.mjs',
+        expect.objectContaining({
+          progressInterval: 10,
+          retries: 2,
+          retryDelay: 5000,
+        }),
+      )
+    })
+
+    it('should download asset with wildcard pattern', async () => {
+      await downloadReleaseAsset(
+        'v1.0.0',
+        'yoga-*.mjs',
+        '/tmp/output.mjs',
+        SOCKET_BTM_REPO,
+        { quiet: true },
+      )
+
+      expect(httpDownload).toHaveBeenCalledWith(
+        'https://github.com/test/repo/releases/download/v1.0.0/yoga-sync-abc.mjs',
+        '/tmp/output.mjs',
+        expect.any(Object),
+      )
+    })
+
+    it('should download asset with brace expansion', async () => {
+      await downloadReleaseAsset(
+        'v1.0.0',
+        '{yoga,models}-*.{mjs,tar.gz}',
+        '/tmp/output',
+        SOCKET_BTM_REPO,
+        { quiet: true },
+      )
+
+      expect(httpDownload).toHaveBeenCalledWith(
+        'https://github.com/test/repo/releases/download/v1.0.0/yoga-sync-abc.mjs',
+        '/tmp/output',
+        expect.any(Object),
+      )
+    })
+
+    it('should throw error when pattern does not match', async () => {
+      await expect(
+        downloadReleaseAsset(
+          'v1.0.0',
+          'nonexistent-*.xyz',
+          '/tmp/output.xyz',
+          SOCKET_BTM_REPO,
+          { quiet: true },
+        ),
+      ).rejects.toThrow('Asset nonexistent-*.xyz not found in release v1.0.0')
+    }, 40_000)
+  })
 })