orca/src/shared/runtime-bootstrap.ts

50 lines
1.4 KiB
TypeScript

import { join } from 'path'
export type RuntimeTransportMetadata =
| {
kind: 'unix'
endpoint: string
}
| {
kind: 'named-pipe'
endpoint: string
}
| {
kind: 'websocket'
endpoint: string
}
export type RuntimeMetadata = {
runtimeId: string
pid: number
transports: RuntimeTransportMetadata[]
authToken: string | null
startedAt: number
}
// Why: the CLI must handle metadata files written by older Orca versions that
// used a singular `transport` field. This helper extracts the first transport
// matching the given kinds from either the new `transports` array or the
// legacy `transport` field.
export function findTransport(
metadata: RuntimeMetadata,
...kinds: RuntimeTransportMetadata['kind'][]
): RuntimeTransportMetadata | null {
const transports = metadata.transports
if (transports && Array.isArray(transports)) {
return transports.find((t) => kinds.includes(t.kind)) ?? null
}
// Why: backward compatibility with pre-transports-array metadata files.
const legacy = (metadata as Record<string, unknown>).transport as RuntimeTransportMetadata | null
if (legacy && kinds.includes(legacy.kind)) {
return legacy
}
return null
}
const PRIMARY_RUNTIME_METADATA_FILE = 'orca-runtime.json'
export function getRuntimeMetadataPath(userDataPath: string): string {
return join(userDataPath, PRIMARY_RUNTIME_METADATA_FILE)
}