orca/config/scripts/workspace-source-exports.test.mjs

import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, expect, it } from 'vitest'
import {
  createWorkspaceSourceResolver,
  workspacePackageManifests
} from './workspace-source-exports.mjs'

const temporary = []
afterEach(() => {
  for (const root of temporary.splice(0)) {
    rmSync(root, { recursive: true, force: true })
  }
})

function fixture({ exports = {}, patterns = ['src/packages/*'], extra = {} } = {}) {
  const root = mkdtempSync(join(tmpdir(), 'workspace-source-exports-'))
  temporary.push(root)
  const files = {
    'pnpm-workspace.yaml': `packages:\n${patterns.map((pattern) => `  - '${pattern}'`).join('\n')}\n`,
    'src/packages/process-host/package.json': JSON.stringify({
      name: '@orca/process-host',
      exports
    }),
    'src/packages/process-host/src/run-process.ts': 'export const value = 1',
    'src/packages/process-host/src/process-spec.ts': 'export type Value = number',
    'src/packages/process-host/dist/run-process.js': 'throw Error("stale build must not execute")',
    ...extra
  }
  for (const [file, source] of Object.entries(files)) {
    const path = join(root, file)
    mkdirSync(join(path, '..'), { recursive: true })
    writeFileSync(path, source)
  }
  return root
}

const publicExports = {
  '.': {
    'orca-source': './src/run-process.ts',
    types: './dist/run-process.d.ts',
    default: './dist/run-process.js'
  },
  './process-spec': {
    'orca-source': './src/process-spec.ts',
    types: './dist/process-spec.d.ts',
    default: './dist/process-spec.js'
  }
}

it('inventories every declared package manifest without requiring built or source exports', () => {
  const root = fixture({
    patterns: ['src/packages/*', 'native/windows-registry'],
    extra: {
      'native/windows-registry/package.json': JSON.stringify({ name: '@orca/windows-registry' }),
      'mobile/packages/model/package.json': JSON.stringify({ name: '@orca/mobile-model' })
    }
  })
  expect(workspacePackageManifests(root)).toEqual([
    'native/windows-registry/package.json',
    'src/packages/process-host/package.json'
  ])
})

it('maps only explicit public source exports with exact aliases independent of compiled output', () => {
  const resolver = createWorkspaceSourceResolver(fixture({ exports: publicExports }))
  expect(resolver.resolve('@orca/process-host')).toMatchObject({
    file: 'src/packages/process-host/src/run-process.ts',
    manifest: 'src/packages/process-host/package.json'
  })
  expect(resolver.resolve('@orca/process-host/process-spec').file).toBe(
    'src/packages/process-host/src/process-spec.ts'
  )
  expect(resolver.aliases.map((alias) => alias.find.test('@orca/process-host'))).toEqual([
    true,
    false
  ])
  expect(resolver.aliases.map((alias) => alias.find.test('@orca/process-host/private'))).toEqual([
    false,
    false
  ])
  expect(resolver.aliases.every((alias) => !alias.replacement.includes('/dist/'))).toBe(true)
  expect(resolver.esbuildAliases).toEqual({
    '@orca/process-host': resolver.resolve('@orca/process-host').path,
    '@orca/process-host/process-spec': resolver.resolve('@orca/process-host/process-spec').path
  })
  expect(resolver.resolve('node:child_process')).toBeNull()
  expect(resolver.resolve('zod')).toBeNull()
})

it.each(['@orca/unknown', '@orca/process-host/private', '@orca/process-host/src/run-process'])(
  'rejects unknown and private internal imports: %s',
  (specifier) => {
    const resolver = createWorkspaceSourceResolver(fixture({ exports: publicExports }))
    expect(() => resolver.resolve(specifier)).toThrow('No public orca-source export')
  }
)

it('requires source metadata instead of trusting a public built export', () => {
  const resolver = createWorkspaceSourceResolver(
    fixture({ exports: { '.': './dist/run-process.js' } })
  )
  expect(() => resolver.resolve('@orca/process-host')).toThrow('No public orca-source export')
})

it('respects excluded workspace packages and independent workspaces', () => {
  const root = fixture({
    exports: publicExports,
    patterns: ['src/packages/*', '!src/packages/process-host'],
    extra: {
      'mobile/packages/model/package.json': JSON.stringify({
        name: '@orca/mobile-model',
        exports: publicExports
      })
    }
  })
  const resolver = createWorkspaceSourceResolver(root)
  expect(resolver.aliases).toEqual([])
  expect(() => resolver.resolve('@orca/process-host')).toThrow('No public orca-source export')
  expect(() => resolver.resolve('@orca/mobile-model')).toThrow('No public orca-source export')
})

it('retains deliberately external native workspace packages', () => {
  const root = fixture({
    patterns: ['native/windows-registry'],
    extra: {
      'native/windows-registry/package.json': JSON.stringify({
        name: '@orca/windows-registry',
        main: 'index.js'
      })
    }
  })
  expect(createWorkspaceSourceResolver(root).resolve('@orca/windows-registry')).toBeNull()
})

it.each([
  '../outside.ts',
  './dist/run-process.js',
  './src/missing.ts',
  './src/../src/run-process.ts',
  './src/run-process.d.ts'
])('rejects unsafe, stale or missing source targets: %s', (target) => {
  const root = fixture({ exports: { '.': { 'orca-source': target } } })
  expect(() => createWorkspaceSourceResolver(root)).toThrow()
})

it('rejects wildcard source exports and duplicate workspace identities', () => {
  expect(() =>
    createWorkspaceSourceResolver(
      fixture({ exports: { './*': { 'orca-source': './src/run-process.ts' } } })
    )
  ).toThrow('must name public entry points')
  const root = fixture({
    exports: publicExports,
    extra: { 'src/packages/duplicate/package.json': JSON.stringify({ name: '@orca/process-host' }) }
  })
  expect(() => createWorkspaceSourceResolver(root)).toThrow('duplicate workspace package name')
})