Wrap runDshSdkCommand so each command times itself and, in a finally block, resolves consent (option A) and sends one best-effort, fire-and-forget telemetry event (redacted cordis.yml + package.json content; never reads .env). Never affects the command's exit code. Adds dsh-scripts -> dsh-telemetry dependency. Default-on via absent consent entry; opt-out by a disabled telemetry entry. The config/create wizard opt-out toggle is deferred (see design doc).
77 lines
2.8 KiB
TypeScript
77 lines
2.8 KiB
TypeScript
/**
|
|
* Internal dsh-sdk command composition used by the package bin.
|
|
*
|
|
* @module @deepseek-ai/dsh-scripts/command
|
|
*/
|
|
|
|
import { parseDshSdkArgs } from './args.ts'
|
|
import { runProjectBuild } from './build.ts'
|
|
import { runConfigCommand, type ConfigCommandContext } from './config.ts'
|
|
import { runCreatePluginCommand } from './create-plugin.ts'
|
|
import { runSDK } from './runtime.ts'
|
|
import { reportCommandTelemetry, type CommandTelemetryEvent } from './telemetry.ts'
|
|
import { DSH_SDK_TEMPLATES } from './templates/dsh-sdk-templates.ts'
|
|
|
|
/** Injectable process and command boundaries used by the dsh-sdk bin. */
|
|
export interface DshSdkCommandContext extends ConfigCommandContext {
|
|
cwd: string
|
|
stdin: NodeJS.ReadStream
|
|
stdout: NodeJS.WriteStream
|
|
stderr: NodeJS.WriteStream
|
|
run?: typeof runSDK
|
|
build?: typeof runProjectBuild
|
|
config?: typeof runConfigCommand
|
|
createPlugin?: typeof runCreatePluginCommand
|
|
telemetry?: (event: CommandTelemetryEvent) => Promise<void>
|
|
}
|
|
|
|
/** Run one parsed dsh-sdk command and return its process exit code. */
|
|
export async function runDshSdkCommand(
|
|
argv: readonly string[] = process.argv.slice(2),
|
|
context: DshSdkCommandContext = {
|
|
cwd: process.cwd(),
|
|
stdin: process.stdin,
|
|
stdout: process.stdout,
|
|
stderr: process.stderr,
|
|
},
|
|
): Promise<number> {
|
|
const startedAt = Date.now()
|
|
let command: string | undefined
|
|
let success = true
|
|
try {
|
|
const args = parseDshSdkArgs(argv)
|
|
if (args.help || !args.command) {
|
|
context.stdout.write(DSH_SDK_TEMPLATES.usage.render({}))
|
|
return 0
|
|
}
|
|
command = args.command
|
|
const run = context.run ?? runSDK
|
|
const build = context.build ?? runProjectBuild
|
|
const config = context.config ?? runConfigCommand
|
|
const createPlugin = context.createPlugin ?? runCreatePluginCommand
|
|
switch (args.command) {
|
|
case 'start': await run(args.target, { cwd: context.cwd, argv: args.forwarded }); break
|
|
case 'dev': await run(args.target, { cwd: context.cwd, dev: true, argv: args.forwarded }); break
|
|
case 'build': await build(args.forwarded, context.cwd); break
|
|
case 'config': {
|
|
const result = await config(context)
|
|
if (result.installError) { success = false; return 1 }
|
|
break
|
|
}
|
|
/* v8 ignore next -- Commander requires <source>, so create never dispatches without it */
|
|
case 'create': await createPlugin(args.source ?? '', context); break
|
|
}
|
|
return 0
|
|
} catch (error) {
|
|
success = false
|
|
context.stderr.write(`dsh-sdk: ${error instanceof Error ? error.message : String(error)}\n`)
|
|
return 1
|
|
} finally {
|
|
if (command !== undefined) {
|
|
/* v8 ignore next -- production telemetry wiring is exercised by the built-bin smoke */
|
|
const telemetry = context.telemetry ?? reportCommandTelemetry
|
|
await telemetry({ command, cwd: context.cwd, durationMs: Date.now() - startedAt, success })
|
|
}
|
|
}
|
|
}
|