forked from microsoft/devicescript
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathsideprotocol.ts
More file actions
140 lines (125 loc) · 3.26 KB
/
sideprotocol.ts
File metadata and controls
140 lines (125 loc) · 3.26 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
import type {
CompilationResult,
ResolvedBuildConfig,
} from "@devicescript/compiler"
import { ConnectionState } from "jacdac-ts"
import type { BuildOptions } from "./build"
export interface SideReq<T extends string = string> {
req: T
seq?: number
data: any
}
export interface SideResp<T extends string = string> {
resp: T
seq?: number
data: any
}
export interface SideEvent<T extends string = string> {
ev: T
data: any
}
export interface SideErrorResp extends SideResp<"error"> {
data: {
message: string
stack?: string
}
}
// enable/disable reception of {bcast:true} packets
export interface SideBcastReq extends SideReq<"bcast"> {
data: { enabled: boolean }
}
export interface SideBuildReq extends SideReq<"build"> {
data: BuildReqArgs
}
export interface SideBuildResp extends SideResp<"build"> {
data: BuildStatus
}
export interface SideKillReq extends SideReq<"kill"> {}
export interface SideKillResp extends SideResp<"kill"> {
data: void
}
export interface SideWatchReq extends SideReq<"watch"> {
data: BuildReqArgs
}
export interface SideWatchResp extends SideResp<"watch"> {
// no real response
data: void
}
// but will get events every now and then
export interface SideWatchEvent extends SideEvent<"watch"> {
data: BuildStatus
}
export interface SideConnectReq extends SideReq<"connect"> {
data: ConnectReqArgs
}
export interface SideSpecsReq extends SideReq<"specs"> {
data: {
dir?: string // if dir===undefined, only global specs will be returned
}
}
export interface VersionInfo {
version: string
runtimeVersion: string
nodeVersion: string
}
export interface SideSpecsData {
buildConfig: ResolvedBuildConfig
versions: VersionInfo
}
export interface SideSpecsResp extends SideResp<"specs"> {
data: SideSpecsData
}
export interface SideStartVmReq extends SideReq<"startVM"> {
data: VmReqArgs
}
export interface SideStartVmResp extends SideResp<"startVM"> {
data: {}
}
export interface SideStopVmReq extends SideReq<"stopVM"> {
data: {}
}
export interface SideStopVmResp extends SideResp<"stopVM"> {
data: void
}
export interface SideTransportEvent extends SideEvent<"transport"> {
data: TransportStatus
}
export interface TransportStatus {
autoConnect?: boolean
transports: {
type: string
connectionState: ConnectionState
description?: string
}[]
}
export interface SideTransportResp extends SideResp<"transport"> {
data: TransportStatus
}
export type OutputFrom = "vm" | "vm-err" | "dev" | "verbose"
export interface SideOutputEvent extends SideEvent<"output"> {
data: {
from: OutputFrom
lines: string[]
}
}
export type BuildStatus = CompilationResult & { deployStatus: string }
export interface BuildReqArgs {
filename: string
buildOptions?: BuildOptions
deployTo?: string // deviceId
}
export interface ConnectReqArgs {
transport?: "serial" | "usb" | "spi" | "websocket" | string
background?: boolean
resourceGroupId?: string
}
export interface WebSocketConnectReqArgs extends ConnectReqArgs {
transport: "websocket"
url: string
protocol: string
}
export interface VmReqArgs {
nativePath?: string
deviceId?: string
gcStress?: boolean
}