feat: export binary from @helia/interop

packages/interop/.aegir.js

@@ -5,6 +5,7 @@ import * as kuboRpcClient from 'kubo-rpc-client'
 /** @type {import('aegir').PartialOptions} */
 export default {
   test: {
+    files: './dist/src/*.spec.js',
     before: async (options) => {
       if (options.runner !== 'node') {
         const ipfsdPort = await getPort()

packages/interop/README.md

@@ -11,6 +11,17 @@
 
 > Interop tests for Helia
 
+# About
+
+Runs interop tests between Helia and Kubo.
+
+## Example - Testing a new Kubo release
+
+```console
+$ npm i @helia/interop
+$ KUBO_BINARY=/path/to/kubo helia-interop
+```
+
 # Install
 
 ```console

packages/interop/package.json

@@ -18,6 +18,9 @@
   "keywords": [
     "IPFS"
   ],
+  "bin": {
+    "helia-interop": "./dist/src/bin.js"
+  },
   "type": "module",
   "types": "./dist/src/index.d.ts",
   "files": [
@@ -52,7 +55,7 @@
     "test:node": "aegir test -t node --cov",
     "test:electron-main": "aegir test -t electron-main"
   },
-  "devDependencies": {
+  "dependencies": {
     "@helia/block-brokers": "^1.0.0",
     "@helia/car": "^2.0.1",
     "@helia/dag-cbor": "^2.0.1",
@@ -88,8 +91,9 @@
     "wherearewe": "^2.0.1"
   },
   "browser": {
-    "./dist/test/fixtures/create-helia.js": "./dist/test/fixtures/create-helia.browser.js",
-    "./dist/test/fixtures/create-kubo.js": "./dist/test/fixtures/create-kubo.browser.js",
+    "./dist/src/fixtures/create-helia.js": "./dist/src/fixtures/create-helia.browser.js",
+    "./dist/src/fixtures/create-kubo.js": "./dist/src/fixtures/create-kubo.browser.js",
+    "./dist/src/bin.js": "./dist/src/index.js",
     "kubo": false
   }
 }

packages/interop/src/bin.ts

@@ -0,0 +1,18 @@
+#! /usr/bin/env node
+/* eslint-disable no-console */
+
+import { spawn } from 'node:child_process'
+
+const test = spawn('npx', ['aegir', 'test'])
+
+test.stdout.on('data', (data) => {
+  process.stdout.write(data)
+})
+
+test.stderr.on('data', (data) => {
+  process.stderr.write(data)
+})
+
+test.on('close', (code) => {
+  process.exit(code ?? 0)
+})

packages/interop/src/index.ts

@@ -1 +1,14 @@
+/**
+ * @packageDocumentation
+ *
+ * Runs interop tests between Helia and Kubo.
+ *
+ * @example Testing a new Kubo release
+ *
+ * ```console
+ * $ npm i @helia/interop
+ * $ KUBO_BINARY=/path/to/kubo helia-interop
+ * ```
+ */
+
 export {}

packages/interop/tsconfig.json

@@ -23,9 +23,6 @@
     {
       "path": "../helia"
     },
-    {
-      "path": "../interface"
-    },
     {
       "path": "../ipns"
     },