dsh-better-chat/tools/client-build.js

306 lines
13 KiB
JavaScript

import { assertPluginSource } from './core-boundary.js'
/**
* Target-aware browser bundle preset for out-of-tree dshx plugins.
*
* Pre-0.2.1 DeepSeek Harness `clientBundle(id)` resolved manifests only from
* two-level directories under `packages/`, while 0.2.1-rc.5
* `clientBundle(packageDir)` still depends on monorepo-internal `scripts/`
* helpers. This standalone adapter reads the package being built from its own
* directory and the shared module table from the target Harness checkout, while
* preserving lazy-CJS registration, shared module identities, CSS ownership,
* inlined image data URLs, and `DSH_CLIENT_*` build-value parity across Host
* and browser halves.
*/
import { existsSync, readFileSync } from 'node:fs'
import { readFile } from 'node:fs/promises'
import { createRequire, isBuiltin } from 'node:module'
import { basename, dirname, extname, isAbsolute, resolve, sep } from 'node:path'
import { fileURLToPath, pathToFileURL } from 'node:url'
import { transform } from 'lightningcss'
import { assertClientCordisInject } from './internal/client-cordis-inject.js'
function clientPlatformPath() {
const requested = process.env.DSHX_HARNESS?.trim()
// Vendored table: dsh-v0.2.2-rc.2 packages/client/web/src/platform.ts.
const fallback = resolve(dirname(fileURLToPath(import.meta.url)), 'harness/packages/client/web/src/platform.ts')
const path = requested ? resolve(requested, 'packages/client/web/src/platform.ts') : fallback
if (!existsSync(path)) {
throw new Error(`dshx client build: target Harness client platform table not found at ${path}`)
}
return path
}
const {
PLATFORM_MODULES,
PRELOADED_CLIENT_EXTERNALS,
} = await import(pathToFileURL(clientPlatformPath()).href)
const CSS_MODULE_PREFIX = '\0dshx-css-module:'
const CSS_GLOBAL_PREFIX = '\0dshx-css-global:'
const CSS_INLINE_PREFIX = '\0dshx-css-inline:'
// Keep Safari 15.4-era -webkit- prefixes: the reader's glass surfaces rely on
// -webkit-backdrop-filter as the fallback for older WebKit.
const CSS_TARGETS = { safari: (15 << 16) | (4 << 8) }
const VIRTUAL_SUFFIX = '.mjs'
const INLINE_QUERY = '?inline'
const TYPES_MARKER = `${sep}lib${sep}types${sep}`
const IMAGE_MEDIA_TYPES = new Map([
['.svg', 'image/svg+xml'],
['.png', 'image/png'],
['.webp', 'image/webp'],
])
// Official packages/client/tsdown.client.ts INLINE_SAFE at dsh-v0.2.1-rc.5.
// Unchanged from dsh-v0.1.7-rc.2, including dsh-api-workspace-controller/default-workspace.
const INLINE_SAFE = /^(?:@deepseek-ai\/dsh-(?:file-reference|session|llm|tools|brand|deque|output-retention|typert-protocol|util-crypto|util-values|util-workspace-path)(?:\/|$)|@deepseek-ai\/dsh-token-meter\/client$|@deepseek-ai\/dsh-native-command\/types$|@deepseek-ai\/dsh-host-open-in-app\/shared$|@deepseek-ai\/dsh-plugin-manager\/registry$|@deepseek-ai\/dsh-agent-preset-registry\/display$|@deepseek-ai\/dsh-api-workspace-controller\/default-workspace$|@deepseek-ai\/dsh-spill-policy\/notice$)/
const VENDORED_LIBRARY = /^@deepseek-ai\/(cosmokit|schemastery)(\/|$)/
const GENERATED_REMOTE = /^@deepseek-ai\/dsh-[a-z0-9]+(?:-[a-z0-9]+)*\/remote$/
function packageManifest(packageRoot) {
const path = resolve(packageRoot, 'package.json')
if (!existsSync(path)) throw new Error(`dshx client build: package.json not found at ${path}`)
return JSON.parse(readFileSync(path, 'utf8'))
}
function clientDeclaration(id, manifest) {
if (manifest.name !== id) {
throw new Error(`dshx client build: config id ${JSON.stringify(id)} does not match package name ${JSON.stringify(manifest.name)}`)
}
const declaration = manifest.dsh?.client
if (declaration === undefined || typeof declaration !== 'object' || declaration === null) {
throw new Error(`dshx client build: ${id} must declare dsh.client`)
}
if (declaration.platform !== 'web') {
throw new Error(`dshx client build: ${id} dsh.client.platform must be "web"`)
}
if (declaration.external !== undefined && (
!Array.isArray(declaration.external)
|| declaration.external.some(value => typeof value !== 'string' || value.length === 0)
)) {
throw new Error(`dshx client build: ${id} dsh.client.external must be an array of non-empty strings`)
}
const external = declaration.external ?? []
const duplicate = external.find((value, index) => external.indexOf(value) !== index)
if (duplicate !== undefined) {
throw new Error(`dshx client build: ${id} dsh.client.external contains duplicate ${JSON.stringify(duplicate)}`)
}
const baseline = new Set([...PLATFORM_MODULES, ...PRELOADED_CLIENT_EXTERNALS])
const repeatedBaseline = external.find(value => baseline.has(value))
if (repeatedBaseline !== undefined) {
throw new Error(`dshx client build: ${id} dsh.client.external repeats implicit baseline module ${JSON.stringify(repeatedBaseline)}`)
}
if (external.includes(id) || external.includes(`${id}/client`)) {
throw new Error(`dshx client build: ${id} dsh.client.external must not request its own package row`)
}
return declaration
}
function clientBuildValueDefines(environment) {
const values = {}
for (const [name, value] of Object.entries(environment)) {
if (!name.startsWith('DSH_CLIENT_') || value === undefined) continue
values[`process.env.${name}`] = JSON.stringify(value)
}
return values
}
function clientDefines(environment) {
const mode = environment.NODE_ENV ?? 'production'
return {
'process.env': '{}',
'process.env.NODE_ENV': JSON.stringify(mode),
'import.meta.env.MODE': JSON.stringify(mode),
'import.meta.env': JSON.stringify({ MODE: mode }),
...clientBuildValueDefines(environment),
}
}
function escapeSpecifier(name) {
return name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
}
function packagePatterns(manifest) {
const names = new Set([
...Object.keys(manifest.dependencies ?? {}),
...Object.keys(manifest.peerDependencies ?? {}),
...Object.keys(manifest.optionalDependencies ?? {}),
])
return [...names].sort().map(name => new RegExp(`^${escapeSpecifier(name)}(/|$)`))
}
function matches(patterns, specifier) {
return patterns.some(pattern => pattern.test(specifier))
}
function styleModule(id, path, css, classMap) {
const tagId = `${id}/${basename(path)}`
const source = [
`const css = ${JSON.stringify(css)};`,
`const tagId = ${JSON.stringify(tagId)};`,
"if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css=' + JSON.stringify(tagId) + ']') === null) {",
" const tag = document.createElement('style');",
` tag.dataset.plugin = ${JSON.stringify(id)};`,
' tag.dataset.pluginCss = tagId;',
' tag.textContent = css;',
' document.head.appendChild(tag);',
'}',
]
source.push(classMap === undefined ? 'export {};' : `export default ${JSON.stringify(classMap)};`)
return source.join('\n')
}
function assetPath(source, importer) {
if (importer === undefined) return source
if (!source.startsWith('.') && !isAbsolute(source)) return createRequire(importer).resolve(source)
const emitted = resolve(dirname(importer), source)
if (existsSync(emitted)) return emitted
const boundary = emitted.indexOf(TYPES_MARKER)
if (boundary < 0) return emitted
return resolve(emitted.slice(0, boundary), 'src', emitted.slice(boundary + TYPES_MARKER.length))
}
function cssPlugins(id, requested) {
return [{
name: 'dshx-client-bundle-purity',
resolveId(source) {
if (!source.startsWith('@deepseek-ai/')) return null
if (requested.has(source)) return null
if (VENDORED_LIBRARY.test(source) || INLINE_SAFE.test(source) || GENERATED_REMOTE.test(source)) return null
throw new Error(
`dshx client bundle purity: ${JSON.stringify(source)} is not a shared baseline or dsh.client.external request; `
+ 'use a Cordis service/slot, a type-only import, or declare the exact dynamic module request',
)
},
}, {
name: 'dshx-css-modules',
resolveId(source, importer) {
if (!source.endsWith('.module.css')) return null
return CSS_MODULE_PREFIX + assetPath(source, importer) + VIRTUAL_SUFFIX
},
async load(virtualId) {
if (!virtualId.startsWith(CSS_MODULE_PREFIX)) return null
const path = virtualId.slice(CSS_MODULE_PREFIX.length, -VIRTUAL_SUFFIX.length)
this.addWatchFile(path)
const source = await readFile(path)
const { code, exports: cssExports } = transform({
filename: path,
code: source,
cssModules: { pattern: '[hash]_[local]' },
targets: CSS_TARGETS,
minify: true,
})
const classMap = {}
for (const [local, value] of Object.entries(cssExports ?? {}).sort(([left], [right]) => left.localeCompare(right))) {
classMap[local] = value.name
}
return styleModule(id, path, code.toString(), classMap)
},
}, {
name: 'dshx-css-inline',
resolveId(source, importer) {
if (!source.endsWith(`.css${INLINE_QUERY}`)) return null
const stylesheet = source.slice(0, -INLINE_QUERY.length)
return CSS_INLINE_PREFIX + assetPath(stylesheet, importer) + VIRTUAL_SUFFIX
},
async load(virtualId) {
if (!virtualId.startsWith(CSS_INLINE_PREFIX)) return null
const path = virtualId.slice(CSS_INLINE_PREFIX.length, -VIRTUAL_SUFFIX.length)
this.addWatchFile(path)
const source = await readFile(path)
const { code } = transform({ filename: path, code: source, targets: CSS_TARGETS, minify: true })
return `export default ${JSON.stringify(code.toString())};`
},
}, {
name: 'dshx-css-global',
resolveId(source, importer) {
if (!source.endsWith('.css') || source.endsWith('.module.css')) return null
return CSS_GLOBAL_PREFIX + assetPath(source, importer) + VIRTUAL_SUFFIX
},
async load(virtualId) {
if (!virtualId.startsWith(CSS_GLOBAL_PREFIX)) return null
const path = virtualId.slice(CSS_GLOBAL_PREFIX.length, -VIRTUAL_SUFFIX.length)
this.addWatchFile(path)
const source = await readFile(path)
const { code } = transform({ filename: path, code: source, targets: CSS_TARGETS, minify: true })
return styleModule(id, path, code.toString())
},
}, {
name: 'dshx-image-inline',
resolveId(source, importer) {
if (importer === undefined || !IMAGE_MEDIA_TYPES.has(extname(source))) return null
return assetPath(source, importer)
},
async load(fileId) {
const mediaType = IMAGE_MEDIA_TYPES.get(extname(fileId))
if (mediaType === undefined) return null
this.addWatchFile(fileId)
const data = await readFile(fileId)
return `export default ${JSON.stringify(`data:${mediaType};base64,${data.toString('base64')}`)};`
},
}]
}
/**
* Build a Host half plus a target-Harness lazy-CJS browser half for one out-of-tree package.
*
* @param {string} id package name and browser graph id.
* @param {readonly string[]} libEntry tsc-emitted Host entries under lib/types.
* @param {{ packageRoot?: string, clientEntry?: string }} options build paths.
* @returns {object[]} tsdown configuration array.
*/
export function externalClientBundle(id, libEntry, options = {}) {
const packageRoot = resolve(options.packageRoot ?? process.cwd())
assertPluginSource(process.env.DSHX_HARNESS, packageRoot)
const manifest = packageManifest(packageRoot)
const declaration = clientDeclaration(id, manifest)
const clientEntry = options.clientEntry ?? 'src/client/index.ts'
assertClientCordisInject(packageRoot, clientEntry)
const requested = new Set([
...PLATFORM_MODULES,
...PRELOADED_CLIENT_EXTERNALS,
...(declaration.external ?? []),
])
const production = packagePatterns(manifest)
const plugins = cssPlugins(id, requested)
return [{
name: id,
entry: [...libEntry],
outDir: 'lib',
format: ['esm'],
platform: 'node',
target: 'es2024',
fixedExtension: false,
dts: false,
clean: false,
define: clientBuildValueDefines(process.env),
deps: {
neverBundle: specifier => matches(production, specifier),
alwaysBundle: specifier => !isBuiltin(specifier) && !matches(production, specifier),
},
}, {
name: `${id}/client`,
entry: { client: clientEntry },
outDir: 'lib',
format: 'cjs',
platform: 'browser',
target: 'es2024',
dts: false,
sourcemap: true,
clean: false,
deps: {
neverBundle: specifier => requested.has(specifier),
alwaysBundle: specifier => !requested.has(specifier),
},
define: clientDefines(process.env),
plugins,
outputOptions: {
entryFileNames: 'client.js',
banner: `window.__ModuleLoader__.load({ id: ${JSON.stringify(id)}, factory: (require) => {`,
footer: 'return module.exports; } });',
intro: 'var module = { exports: {} }; var exports = module.exports;',
},
}]
}