brainy/tests/integration/bun-runtime-test.ts
David Snelling ca9129a924 chore(8.0): modernize toolchain + position Bun as a runtime
Consumer-invisible modernization pass — no public API or runtime-behavior
change; dist for the override-only files is byte-identical.

Toolchain:
- CI: GitHub Actions matrix — Node 22/24 (test:unit) + Bun latest (test:bun).
- engines: node ">=22" (was "22.x"), bun ">=1.1.0".
- tsconfig: isolatedModules + noImplicitOverride; add the 33 `override`
  modifiers the flag requires across storage/integrations/vfs/transaction.
- deps: @types/node ^22; add prettier; drop dead standard-version,
  @rollup/plugin-* and the redundant embedded eslintConfig (flat
  eslint.config.js is the active config — verified identical lint output).

paramValidation: replace the top-level `await import('node:os'/'node:fs')`
with static ESM imports. The top-level-await form poisoned the module graph;
static imports also drop the browser/edge fallback branches no supported
runtime reaches (8.0 is Node/Bun/Deno-only).

Bun positioning: recommend Bun as a runtime (`bun add` / `bun run`), which is
green (test:bun 8/8). Drop single-binary `bun build --compile` as a target —
native addons cannot embed into it, and Bun 1.3.10 has a `--compile` codegen
regression around top-level await. Rename the Bun test to bun-runtime-test.ts
and correct docs that overclaimed single-binary support.

Gates: typecheck 0, build 0, test:unit 1743/1743, test:bun 8/8.
2026-07-01 09:16:46 -07:00

164 lines
5.9 KiB
TypeScript

/**
* Bun Runtime Test
*
* Tests that Brainy runs correctly under the Bun runtime (`bun add` / `bun run`) —
* the supported Bun story. Verifies:
* 1. No native binaries required (pure WASM)
* 2. Model is properly bundled
* 3. Embeddings work without network access
*
* To run manually:
* bun tests/integration/bun-runtime-test.ts
*/
import { Brainy } from '../../dist/index.js'
import { embeddingManager } from '../../dist/embeddings/EmbeddingManager.js'
import { WASMEmbeddingEngine } from '../../dist/embeddings/wasm/index.js'
async function testBunRuntime() {
const results: { test: string; passed: boolean; error?: string }[] = []
console.log('🚀 Brainy Bun Runtime Test\n')
console.log('Runtime:', typeof Bun !== 'undefined' ? `Bun ${Bun.version}` : `Node.js ${process.version}`)
console.log('')
// Test 1: WASM Engine initialization
try {
console.log('1. Testing WASM Engine initialization...')
const engine = WASMEmbeddingEngine.getInstance()
await engine.initialize()
console.log(' ✅ WASM Engine initialized')
results.push({ test: 'WASM Engine init', passed: true })
} catch (error) {
console.log(' ❌ WASM Engine failed:', (error as Error).message)
results.push({ test: 'WASM Engine init', passed: false, error: (error as Error).message })
}
// Test 2: Generate embedding
try {
console.log('2. Testing embedding generation...')
const engine = WASMEmbeddingEngine.getInstance()
const embedding = await engine.embed('Hello from Bun!')
if (embedding.length !== 384) {
throw new Error(`Expected 384 dimensions, got ${embedding.length}`)
}
console.log(` ✅ Generated ${embedding.length}-dim embedding`)
results.push({ test: 'Embedding generation', passed: true })
} catch (error) {
console.log(' ❌ Embedding failed:', (error as Error).message)
results.push({ test: 'Embedding generation', passed: false, error: (error as Error).message })
}
// Test 3: Semantic similarity
try {
console.log('3. Testing semantic similarity...')
const engine = WASMEmbeddingEngine.getInstance()
const catEmb = await engine.embed('The cat sat on the mat')
const felineEmb = await engine.embed('A feline rests on a rug')
const stockEmb = await engine.embed('Stock market crash')
const cosineSim = (a: number[], b: number[]) => {
let dot = 0
for (let i = 0; i < a.length; i++) dot += a[i] * b[i]
return dot // Already normalized
}
const similarSim = cosineSim(catEmb, felineEmb)
const dissimilarSim = cosineSim(catEmb, stockEmb)
if (similarSim <= dissimilarSim) {
throw new Error(`Semantic similarity failed: similar=${similarSim.toFixed(4)}, dissimilar=${dissimilarSim.toFixed(4)}`)
}
console.log(` ✅ Semantic similarity works (similar: ${similarSim.toFixed(4)} > dissimilar: ${dissimilarSim.toFixed(4)})`)
results.push({ test: 'Semantic similarity', passed: true })
} catch (error) {
console.log(' ❌ Semantic similarity failed:', (error as Error).message)
results.push({ test: 'Semantic similarity', passed: false, error: (error as Error).message })
}
// Test 4: EmbeddingManager
try {
console.log('4. Testing EmbeddingManager...')
await embeddingManager.init()
const emb = await embeddingManager.embed('Test via manager')
if (emb.length !== 384) {
throw new Error(`Expected 384 dimensions, got ${emb.length}`)
}
console.log(' ✅ EmbeddingManager works')
results.push({ test: 'EmbeddingManager', passed: true })
} catch (error) {
console.log(' ❌ EmbeddingManager failed:', (error as Error).message)
results.push({ test: 'EmbeddingManager', passed: false, error: (error as Error).message })
}
// Test 5: Full Brainy initialization with fresh memory storage
try {
console.log('5. Testing Brainy initialization (in-memory)...')
const brain = new Brainy({ requireSubtype: false,
storage: 'memory',
storageOptions: { path: ':memory:' }
})
await brain.init()
console.log(' ✅ Brainy initialized')
results.push({ test: 'Brainy init', passed: true })
// Test 6: Add document
console.log('6. Testing document add...')
const docId = await brain.add({ data: 'Machine learning concepts', type: 'concept' })
if (!docId || typeof docId !== 'string') {
throw new Error('Document add returned no ID')
}
console.log(` ✅ Document added: ${docId}`)
results.push({ test: 'Document add', passed: true })
// Test 7: Search
console.log('7. Testing semantic search...')
const searchResults = await brain.find('AI')
console.log(` ✅ Search returned ${searchResults.length} results`)
results.push({ test: 'Semantic search', passed: true })
// Test 8: Get document
console.log('8. Testing document retrieval...')
const retrieved = await brain.get(docId)
if (!retrieved) {
throw new Error('Document not found')
}
console.log(' ✅ Document retrieved')
results.push({ test: 'Document retrieval', passed: true })
await brain.close()
} catch (error) {
console.log(' ❌ Brainy test failed:', (error as Error).message)
results.push({ test: 'Brainy operations', passed: false, error: (error as Error).message })
}
// Summary
console.log('\n' + '='.repeat(50))
console.log('SUMMARY')
console.log('='.repeat(50))
const passed = results.filter(r => r.passed).length
const failed = results.filter(r => !r.passed).length
for (const r of results) {
console.log(`${r.passed ? '✅' : '❌'} ${r.test}${r.error ? `: ${r.error}` : ''}`)
}
console.log('')
console.log(`Passed: ${passed}/${results.length}`)
console.log(`Failed: ${failed}/${results.length}`)
if (failed > 0) {
console.log('\n❌ Some tests failed!')
process.exit(1)
} else {
console.log('\n✅ All tests passed! Brainy runs under Bun.')
process.exit(0)
}
}
// Run tests
testBunRuntime().catch(error => {
console.error('Fatal error:', error)
process.exit(1)
})