Add integration tests using isolatePackage helper

- Test package installation in isolated environment
- Verify all entry points load correctly
- Test PackageURL, PackageURLBuilder, and UrlConverter functionality
- Use correct dist/ import paths per package.json exports

Author: jdalton

package.json

@@ -75,7 +75,7 @@
     "@dotenvx/dotenvx": "1.49.0",
     "@eslint/compat": "1.3.2",
     "@eslint/js": "9.35.0",
-    "@socketsecurity/registry": "1.4.6",
+    "@socketsecurity/registry": "1.5.0",
     "@types/node": "24.5.2",
     "@typescript/native-preview": "7.0.0-dev.20250926.1",
     "@vitest/coverage-v8": "3.2.4",

pnpm-lock.yaml

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Integration tests using socket-registry test helpers.
+ * Tests the package in an isolated environment with installed dependencies.
+ */
+
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { describe, expect, it } from 'vitest'
+
+import { isolatePackage } from '../../socket-registry/test/utils/test-helpers.mjs'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const packagePath = path.resolve(__dirname, '..')
+
+describe('Integration tests', () => {
+  it('should install and load package successfully', async () => {
+    const { pkgPath } = await isolatePackage(packagePath)
+
+    // Test that we can import the package
+    const { PackageURL } = await import(`${pkgPath}/dist/package-url.js`)
+    expect(PackageURL).toBeDefined()
+    expect(typeof PackageURL).toBe('function')
+
+    // Test basic functionality
+    const purl = new PackageURL('npm', undefined, 'lodash', '4.17.21')
+    expect(purl.toString()).toBe('pkg:npm/[email protected]')
+  })
+
+  it('should load PackageURLBuilder and work correctly', async () => {
+    const { pkgPath } = await isolatePackage(packagePath)
+
+    const { PackageURLBuilder } = await import(`${pkgPath}/dist/package-url.js`)
+    expect(PackageURLBuilder).toBeDefined()
+    expect(typeof PackageURLBuilder.create).toBe('function')
+
+    // Test basic functionality
+    const purl = PackageURLBuilder.create()
+      .type('npm')
+      .name('lodash')
+      .version('4.17.21')
+      .build()
+    expect(purl.toString()).toBe('pkg:npm/[email protected]')
+  })
+
+  it('should load UrlConverter and work correctly', async () => {
+    const { pkgPath } = await isolatePackage(packagePath)
+
+    const { UrlConverter } = await import(`${pkgPath}/dist/url-converter.js`)
+    const { PackageURL } = await import(`${pkgPath}/dist/package-url.js`)
+
+    expect(UrlConverter).toBeDefined()
+    expect(typeof UrlConverter.toRepositoryUrl).toBe('function')
+
+    // Test basic functionality
+    const purl = new PackageURL('npm', undefined, 'lodash', '4.17.21')
+    const result = UrlConverter.toRepositoryUrl(purl)
+    expect(result).toEqual({
+      url: 'https://npmjs.com/package/lodash',
+      type: 'web',
+    })
+  })
+
+  it('should have all entry points working together', async () => {
+    const { pkgPath } = await isolatePackage(packagePath)
+
+    const { PackageURL, PackageURLBuilder } = await import(
+      `${pkgPath}/dist/package-url.js`
+    )
+    const { UrlConverter } = await import(`${pkgPath}/dist/url-converter.js`)
+
+    // Build a purl
+    const purl = PackageURLBuilder.create()
+      .type('npm')
+      .namespace('@types')
+      .name('node')
+      .version('16.11.7')
+      .build()
+
+    // Convert to string (namespace @ is URL-encoded as %40)
+    expect(purl.toString()).toBe('pkg:npm/%40types/[email protected]')
+
+    // Get URLs
+    const urls = UrlConverter.getAllUrls(purl)
+    expect(urls.repository).toBeDefined()
+    expect(urls.download).toBeDefined()
+
+    // Parse back
+    const parsed = PackageURL.fromString(purl.toString())
+    expect(parsed.type).toBe('npm')
+    expect(parsed.namespace).toBe('@types')
+    expect(parsed.name).toBe('node')
+    expect(parsed.version).toBe('16.11.7')
+  })
+})