AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
TypeScript ai-agentai-agent-toolsai-agentsai-agents-frameworkmcpmcp-servermcp-toolsmcpsn8n-alternativeno-code-automationworkflowworkflow-automationworkflows
import { mkdtempSync, mkdirSync, writeFileSync, rmSync, readFileSync, realpathSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, describe, expect, it } from 'vitest'
import { bundlePieceUtils } from './bundle-piece-utils'
describe('bundlePiece — external dependency capture', () => {
let root: string | undefined
afterEach(() => {
if (root) {
rmSync(root, { recursive: true, force: true })
root = undefined
}
})
it('captures a native dep reached transitively through an inlined package', async () => {
root = realpathSync(mkdtempSync(join(tmpdir(), 'ap-bundle-')))
const sdkDir = join(root, 'node_modules', 'fake-sdk')
mkdirSync(sdkDir, { recursive: true })
writeFileSync(join(sdkDir, 'package.json'), JSON.stringify({ name: 'fake-sdk', version: '1.0.0', main: 'index.js' }))
writeFileSync(join(sdkDir, 'index.js'), 'const db = require(\'better-sqlite3\');\nmodule.exports = { db };\n')
const piecePath = join(root, 'piece')
mkdirSync(join(piecePath, 'src'), { recursive: true })
writeFileSync(join(piecePath, 'package.json'), JSON.stringify({ name: 'piece-x', version: '0.0.1', dependencies: { 'fake-sdk': '1.0.0' } }))
writeFileSync(join(piecePath, 'src', 'index.ts'), 'import { db } from \'fake-sdk\'\nexport const piece = { db }\n')
const distPath = join(piecePath, 'dist')
mkdirSync(distPath, { recursive: true })
const result = await bundlePieceUtils.bundlePiece({ piecePath, distPath, repoRoot: root })
expect(result.external).toContain('better-sqlite3')
expect(result.inlined).toContain('fake-sdk')
expect(result.external).not.toContain('fake-sdk')
})
it('keeps wasm/native asset packages (tiktoken, sharp) external so their runtime-loaded assets resolve', async () => {
root = realpathSync(mkdtempSync(join(tmpdir(), 'ap-bundle-')))
for (const [name, version] of [['tiktoken', '1.0.11'], ['sharp', '0.35.2']]) {
const depDir = join(root, 'node_modules', name)
mkdirSync(depDir, { recursive: true })
writeFileSync(join(depDir, 'package.json'), JSON.stringify({ name, version, main: 'index.js' }))
writeFileSync(join(depDir, 'index.js'), 'module.exports = {};\n')
}
const piecePath = join(root, 'piece')
mkdirSync(join(piecePath, 'src'), { recursive: true })
writeFileSync(join(piecePath, 'package.json'), JSON.stringify({ name: 'piece-z', version: '0.0.1', dependencies: { tiktoken: '1.0.11', sharp: '0.35.2' } }))
writeFileSync(join(piecePath, 'src', 'index.ts'), 'import * as tiktoken from \'tiktoken\'\nimport * as sharp from \'sharp\'\nexport const piece = { tiktoken, sharp }\n')
const distPath = join(piecePath, 'dist')
mkdirSync(distPath, { recursive: true })
const result = await bundlePieceUtils.bundlePiece({ piecePath, distPath, repoRoot: root })
expect(result.external).toContain('tiktoken')
expect(result.external).toContain('sharp')
expect(result.inlined).not.toContain('tiktoken')
expect(result.inlined).not.toContain('sharp')
})
it('externalizes an inlined package that relies on import.meta', async () => {
root = realpathSync(mkdtempSync(join(tmpdir(), 'ap-bundle-')))
const esmDir = join(root, 'node_modules', 'esm-dep')
mkdirSync(esmDir, { recursive: true })
writeFileSync(join(esmDir, 'package.json'), JSON.stringify({ name: 'esm-dep', version: '1.0.0', main: 'index.js' }))
writeFileSync(join(esmDir, 'index.js'), 'const { createRequire } = require(\'module\');\nconst req = createRequire(import.meta.url);\nmodule.exports = { req };\n')
const piecePath = join(root, 'piece')
mkdirSync(join(piecePath, 'src'), { recursive: true })
writeFileSync(join(piecePath, 'package.json'), JSON.stringify({ name: 'piece-y', version: '0.0.1', dependencies: { 'esm-dep': '1.0.0' } }))
writeFileSync(join(piecePath, 'src', 'index.ts'), 'import { req } from \'esm-dep\'\nexport const piece = { req }\n')
const distPath = join(piecePath, 'dist')
mkdirSync(distPath, { recursive: true })
const result = await bundlePieceUtils.bundlePiece({ piecePath, distPath, repoRoot: root })
expect(result.external).toContain('esm-dep')
expect(result.inlined).not.toContain('esm-dep')
})
})
describe('bundlePiece — forked sibling entries (GIT-1772)', () => {
let root: string | undefined
afterEach(() => {
if (root) {
rmSync(root, { recursive: true, force: true })
root = undefined
}
})
function setupForkingPiece({ declareEntry }: { declareEntry: boolean }): string {
root = realpathSync(mkdtempSync(join(tmpdir(), 'ap-bundle-')))
const dbDir = join(root, 'node_modules', 'oracledb')
mkdirSync(dbDir, { recursive: true })
writeFileSync(join(dbDir, 'package.json'), JSON.stringify({ name: 'oracledb', version: '6.10.0', main: 'index.js' }))
writeFileSync(join(dbDir, 'index.js'), 'module.exports = {};\n')
const piecePath = join(root, 'piece')
mkdirSync(join(piecePath, 'src', 'lib'), { recursive: true })
writeFileSync(join(piecePath, 'package.json'), JSON.stringify({
name: 'piece-forking',
version: '0.0.1',
dependencies: { oracledb: '6.10.0' },
...(declareEntry ? { bundleForkedEntries: ['src/lib/runner.ts'] } : {}),
}))
writeFileSync(join(piecePath, 'src', 'index.ts'), 'import { start } from \'./lib/pool\'\nexport const piece = { start }\n')
writeFileSync(join(piecePath, 'src', 'lib', 'pool.ts'), 'import { fork } from \'child_process\'\nimport { join } from \'path\'\nexport const start = () => fork(join(__dirname, \'runner.js\'))\n')
writeFileSync(join(piecePath, 'src', 'lib', 'protocol.ts'), 'export const READY_MESSAGE = \'runner-ready\'\n')
writeFileSync(join(piecePath, 'src', 'lib', 'runner.ts'), 'import db from \'oracledb\'\nimport { READY_MESSAGE } from \'./protocol\'\nconsole.log(READY_MESSAGE, db)\n')
mkdirSync(join(piecePath, 'dist'), { recursive: true })
return piecePath
}
it('emits a declared forked entry beside the main bundle and keeps its native dep external', async () => {
const piecePath = setupForkingPiece({ declareEntry: true })
const result = await bundlePieceUtils.bundlePiece({ piecePath, distPath: join(piecePath, 'dist'), repoRoot: root! })
expect(result.extraBundleFiles).toEqual(['src/runner.js'])
const runnerBundle = readFileSync(join(piecePath, 'dist', 'src', 'runner.js'), 'utf-8')
expect(runnerBundle).toContain('runner-ready')
expect(runnerBundle).toContain('require("oracledb")')
expect(result.external).toContain('oracledb')
})
it('fails loudly when piece source uses __dirname without declaring a forked entry', async () => {
const piecePath = setupForkingPiece({ declareEntry: false })
await expect(bundlePieceUtils.bundlePiece({ piecePath, distPath: join(piecePath, 'dist'), repoRoot: root! }))
.rejects.toThrow(/bundleForkedEntries/)
})
it('fails loudly on a declared entry that does not exist', async () => {
const piecePath = setupForkingPiece({ declareEntry: true })
rmSync(join(piecePath, 'src', 'lib', 'runner.ts'))
await expect(bundlePieceUtils.bundlePiece({ piecePath, distPath: join(piecePath, 'dist'), repoRoot: root! }))
.rejects.toThrow(/no file at/)
})
it('fails loudly when two declared entries collide on the same output name', async () => {
const piecePath = setupForkingPiece({ declareEntry: true })
mkdirSync(join(piecePath, 'src', 'lib', 'other'), { recursive: true })
writeFileSync(join(piecePath, 'src', 'lib', 'other', 'runner.ts'), 'export const other = true\n')
writeFileSync(join(piecePath, 'package.json'), JSON.stringify({
name: 'piece-forking',
version: '0.0.1',
dependencies: { oracledb: '6.10.0' },
bundleForkedEntries: ['src/lib/runner.ts', 'src/lib/other/runner.ts'],
}))
await expect(bundlePieceUtils.bundlePiece({ piecePath, distPath: join(piecePath, 'dist'), repoRoot: root! }))
.rejects.toThrow(/collides with another declared entry/)
})
it('fails loudly when two declared entries collide on output name differing only by case', async () => {
const piecePath = setupForkingPiece({ declareEntry: true })
mkdirSync(join(piecePath, 'src', 'lib', 'other'), { recursive: true })
writeFileSync(join(piecePath, 'src', 'lib', 'other', 'RUNNER.ts'), 'export const other = true\n')
writeFileSync(join(piecePath, 'package.json'), JSON.stringify({
name: 'piece-forking',
version: '0.0.1',
dependencies: { oracledb: '6.10.0' },
bundleForkedEntries: ['src/lib/runner.ts', 'src/lib/other/RUNNER.ts'],
}))
await expect(bundlePieceUtils.bundlePiece({ piecePath, distPath: join(piecePath, 'dist'), repoRoot: root! }))
.rejects.toThrow(/collides with another declared entry/)
})
})