fix: expose documented package subpaths

package.json

@@ -11,7 +11,9 @@
     ".": "./src/index.js",
     "./web": "./src/web.js",
     "./fixtures": "./src/fixtures.js",
+    "./fixture-io": "./src/fixture-io.js",
     "./integrations": "./src/integrations.js",
+    "./recorder": "./src/recorder.js",
     "./tuning": "./src/tuning.js"
   },
   "files": [
@@ -32,7 +34,8 @@
     "test": "node --test",
     "typecheck": "tsc --project tsconfig.json",
     "build": "node scripts/build.mjs",
-    "package:smoke": "node scripts/verify-package.mjs && npm pack --dry-run",
+    "package:imports": "node scripts/verify-documented-imports.mjs",
+    "package:smoke": "node scripts/verify-package.mjs && npm run package:imports && npm pack --dry-run",
     "release:check": "npm run check && npm test && npm run typecheck && npm run build && npm run smoke && npm run package:smoke",
     "smoke": "node test/fixtures.test.js",
     "lint": "npm run check"

scripts/verify-documented-imports.mjs

@@ -0,0 +1,63 @@
+import { execFileSync } from 'node:child_process';
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+const projectRoot = new URL('..', import.meta.url);
+const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+const apiDocs = readFileSync(new URL('../docs/API.md', import.meta.url), 'utf8');
+const documentedImports = [
+  ...new Set(
+    [...apiDocs.matchAll(/\bfrom\s+['"](@bargekit\/core(?:\/[^'"]+)?)['"]/g)]
+      .map((match) => match[1])
+  )
+];
+
+if (documentedImports.length === 0) {
+  throw new Error('docs/API.md does not contain any @bargekit/core imports');
+}
+
+const consumerDir = mkdtempSync(join(tmpdir(), 'bargekit-package-consumer-'));
+
+try {
+  const packResult = JSON.parse(execFileSync(
+    'npm',
+    ['pack', '--json', '--pack-destination', consumerDir],
+    { cwd: projectRoot, encoding: 'utf8' }
+  ));
+  const packed = packResult[0];
+  const packedPaths = new Set(packed.files.map((file) => file.path));
+
+  for (const specifier of documentedImports) {
+    const subpath = specifier.slice(packageJson.name.length) || '.';
+    const exportKey = subpath === '.' ? '.' : `.${subpath}`;
+    const target = packageJson.exports?.[exportKey];
+
+    if (!target) {
+      throw new Error(`${specifier} is documented but missing from package.json exports`);
+    }
+    if (!packedPaths.has(target.replace(/^\.\//, ''))) {
+      throw new Error(`${specifier} targets ${target}, which is missing from the packed tarball`);
+    }
+  }
+
+  const tarballPath = join(consumerDir, packed.filename);
+  writeFileSync(
+    join(consumerDir, 'package.json'),
+    JSON.stringify({ private: true, type: 'module' })
+  );
+  execFileSync(
+    'npm',
+    ['install', '--ignore-scripts', '--no-audit', '--no-fund', tarballPath],
+    { cwd: consumerDir, stdio: 'inherit' }
+  );
+  writeFileSync(
+    join(consumerDir, 'verify.mjs'),
+    `await Promise.all(${JSON.stringify(documentedImports)}.map((specifier) => import(specifier)));\n`
+  );
+  execFileSync('node', ['verify.mjs'], { cwd: consumerDir, stdio: 'inherit' });
+
+  console.log(`verified documented imports from packed tarball: ${documentedImports.join(', ')}`);
+} finally {
+  rmSync(consumerDir, { recursive: true, force: true });
+}