widget-api.models.ts
3.93 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
///
/// Copyright © 2016-2019 The Thingsboard Authors
///
/// Licensed under the Apache License, Version 2.0 (the "License");
/// you may not use this file except in compliance with the License.
/// You may obtain a copy of the License at
///
/// http://www.apache.org/licenses/LICENSE-2.0
///
/// Unless required by applicable law or agreed to in writing, software
/// distributed under the License is distributed on an "AS IS" BASIS,
/// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
/// See the License for the specific language governing permissions and
/// limitations under the License.
///
import { Observable } from 'rxjs';
import { EntityId } from '@app/shared/models/id/entity-id';
import { WidgetActionDescriptor, widgetType } from '@shared/models/widget.models';
import { TimeService } from '../services/time.service';
import { DeviceService } from '../http/device.service';
import { AlarmService } from '../http/alarm.service';
import { UtilsService } from '@core/services/utils.service';
export interface TimewindowFunctions {
onUpdateTimewindow: (startTimeMs: number, endTimeMs: number, interval: number) => void;
onResetTimewindow: () => void;
}
export interface WidgetSubscriptionApi {
createSubscription: (options: WidgetSubscriptionOptions, subscribe: boolean) => Observable<IWidgetSubscription>;
createSubscriptionFromInfo: (type: widgetType, subscriptionsInfo: Array<SubscriptionInfo>,
options: WidgetSubscriptionOptions, useDefaultComponents: boolean, subscribe: boolean)
=> Observable<IWidgetSubscription>;
removeSubscription: (id: string) => void;
}
export interface RpcApi {
sendOneWayCommand: (method: string, params?: any, timeout?: number) => Observable<any>;
sendTwoWayCommand: (method: string, params?: any, timeout?: number) => Observable<any>;
}
export interface IWidgetUtils {
formatValue: (value: any, dec?: number, units?: string, showZeroDecimals?: boolean) => string | undefined;
}
export interface WidgetActionsApi {
actionDescriptorsBySourceId: {[sourceId: string]: Array<WidgetActionDescriptor>};
getActionDescriptors: (actionSourceId: string) => Array<WidgetActionDescriptor>;
handleWidgetAction: ($event: Event, descriptor: WidgetActionDescriptor,
entityId?: EntityId, entityName?: string, additionalParams?: any) => void;
elementClick: ($event: Event) => void;
}
export interface IAliasController {
[key: string]: any | null;
// TODO:
}
export interface StateObject {
id?: string;
params?: StateParams;
}
export interface StateParams {
entityName?: string;
targetEntityParamName?: string;
entityId?: EntityId;
[key: string]: any | null;
}
export interface IStateController {
getStateParams: () => StateParams;
openState: (id: string, params?: StateParams, openRightLayout?: boolean) => void;
updateState: (id?: string, params?: StateParams, openRightLayout?: boolean) => void;
// TODO:
}
export interface EntityInfo {
entityId: EntityId;
entityName: string;
}
export interface SubscriptionInfo {
[key: string]: any;
// TODO:
}
export interface WidgetSubscriptionContext {
timeService: TimeService;
deviceService: DeviceService;
alarmService: AlarmService;
utils: UtilsService;
widgetUtils: IWidgetUtils;
dashboardTimewindowApi: TimewindowFunctions;
getServerTimeDiff: Observable<number>;
aliasController: IAliasController;
[key: string]: any;
// TODO:
}
export interface WidgetSubscriptionOptions {
[key: string]: any;
// TODO:
}
export interface IWidgetSubscription {
onUpdateTimewindow: (startTimeMs: number, endTimeMs: number, interval: number) => void;
onResetTimewindow: () => void;
sendOneWayCommand: (method: string, params?: any, timeout?: number) => Observable<any>;
sendTwoWayCommand: (method: string, params?: any, timeout?: number) => Observable<any>;
clearRpcError: () => void;
getFirstEntityInfo: () => EntityInfo;
destroy(): void;
[key: string]: any;
// TODO:
}