@fluidframework/core-interfaces 2.0.0-dev.7.4.0.216897 → 2.0.0-dev.7.4.0.217884
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/api-report/core-interfaces.api.md +49 -41
- package/dist/config.d.ts +35 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +7 -0
- package/dist/config.js.map +1 -0
- package/dist/core-interfaces-alpha.d.ts +738 -63
- package/dist/core-interfaces-beta.d.ts +4 -0
- package/dist/core-interfaces-public.d.ts +4 -0
- package/dist/core-interfaces-untrimmed.d.ts +74 -41
- package/dist/disposable.d.ts +1 -1
- package/dist/disposable.js.map +1 -1
- package/dist/error.d.ts +2 -1
- package/dist/error.d.ts.map +1 -1
- package/dist/error.js.map +1 -1
- package/dist/events.d.ts +8 -8
- package/dist/events.js.map +1 -1
- package/dist/fluidLoadable.d.ts +3 -3
- package/dist/fluidLoadable.js +1 -1
- package/dist/fluidLoadable.js.map +1 -1
- package/dist/fluidRouter.d.ts +6 -6
- package/dist/fluidRouter.js +1 -1
- package/dist/fluidRouter.js.map +1 -1
- package/dist/handles.d.ts +6 -6
- package/dist/handles.js +2 -2
- package/dist/handles.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/logger.d.ts +13 -13
- package/dist/logger.js +1 -1
- package/dist/logger.js.map +1 -1
- package/dist/provider.d.ts +3 -3
- package/dist/provider.js.map +1 -1
- package/lib/config.d.ts +35 -0
- package/lib/config.d.ts.map +1 -0
- package/lib/config.js +6 -0
- package/lib/config.js.map +1 -0
- package/lib/core-interfaces-alpha.d.ts +738 -63
- package/lib/core-interfaces-beta.d.ts +4 -0
- package/lib/core-interfaces-public.d.ts +4 -0
- package/lib/core-interfaces-untrimmed.d.ts +74 -41
- package/lib/disposable.d.ts +1 -1
- package/lib/disposable.js.map +1 -1
- package/lib/error.d.ts +2 -1
- package/lib/error.d.ts.map +1 -1
- package/lib/error.js.map +1 -1
- package/lib/events.d.ts +8 -8
- package/lib/events.js.map +1 -1
- package/lib/fluidLoadable.d.ts +3 -3
- package/lib/fluidLoadable.js +1 -1
- package/lib/fluidLoadable.js.map +1 -1
- package/lib/fluidRouter.d.ts +6 -6
- package/lib/fluidRouter.js +1 -1
- package/lib/fluidRouter.js.map +1 -1
- package/lib/handles.d.ts +6 -6
- package/lib/handles.js +2 -2
- package/lib/handles.js.map +1 -1
- package/lib/index.d.ts +1 -0
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js.map +1 -1
- package/lib/logger.d.ts +13 -13
- package/lib/logger.js +1 -1
- package/lib/logger.js.map +1 -1
- package/lib/provider.d.ts +3 -3
- package/lib/provider.js.map +1 -1
- package/package.json +2 -2
- package/src/config.ts +36 -0
- package/src/disposable.ts +1 -1
- package/src/error.ts +2 -1
- package/src/events.ts +8 -8
- package/src/fluidLoadable.ts +3 -3
- package/src/fluidRouter.ts +6 -6
- package/src/handles.ts +6 -6
- package/src/index.ts +1 -0
- package/src/logger.ts +13 -13
- package/src/provider.ts +3 -3
package/src/handles.ts
CHANGED
|
@@ -8,12 +8,12 @@ import { IFluidLoadable } from "./fluidLoadable";
|
|
|
8
8
|
import { FluidObject } from "./provider";
|
|
9
9
|
|
|
10
10
|
/**
|
|
11
|
-
* @
|
|
11
|
+
* @alpha
|
|
12
12
|
*/
|
|
13
13
|
export const IFluidHandleContext: keyof IProvideFluidHandleContext = "IFluidHandleContext";
|
|
14
14
|
|
|
15
15
|
/**
|
|
16
|
-
* @
|
|
16
|
+
* @alpha
|
|
17
17
|
*/
|
|
18
18
|
export interface IProvideFluidHandleContext {
|
|
19
19
|
readonly IFluidHandleContext: IFluidHandleContext;
|
|
@@ -21,7 +21,7 @@ export interface IProvideFluidHandleContext {
|
|
|
21
21
|
|
|
22
22
|
/**
|
|
23
23
|
* Describes a routing context from which other `IFluidHandleContext`s are defined.
|
|
24
|
-
* @
|
|
24
|
+
* @alpha
|
|
25
25
|
*/
|
|
26
26
|
export interface IFluidHandleContext extends IProvideFluidHandleContext {
|
|
27
27
|
/**
|
|
@@ -49,12 +49,12 @@ export interface IFluidHandleContext extends IProvideFluidHandleContext {
|
|
|
49
49
|
}
|
|
50
50
|
|
|
51
51
|
/**
|
|
52
|
-
* @
|
|
52
|
+
* @alpha
|
|
53
53
|
*/
|
|
54
54
|
export const IFluidHandle: keyof IProvideFluidHandle = "IFluidHandle";
|
|
55
55
|
|
|
56
56
|
/**
|
|
57
|
-
* @
|
|
57
|
+
* @alpha
|
|
58
58
|
*/
|
|
59
59
|
export interface IProvideFluidHandle {
|
|
60
60
|
readonly IFluidHandle: IFluidHandle;
|
|
@@ -62,7 +62,7 @@ export interface IProvideFluidHandle {
|
|
|
62
62
|
|
|
63
63
|
/**
|
|
64
64
|
* Handle to a shared {@link FluidObject}.
|
|
65
|
-
* @
|
|
65
|
+
* @alpha
|
|
66
66
|
*/
|
|
67
67
|
export interface IFluidHandle<
|
|
68
68
|
// REVIEW: Constrain `T` to something? How do we support dds and datastores safely?
|
package/src/index.ts
CHANGED
package/src/logger.ts
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
* Examples of known categories, however category can be any string for extensibility.
|
|
8
8
|
*
|
|
9
9
|
* @deprecated Moved to \@fluidframework/telemetry-utils package
|
|
10
|
-
* @
|
|
10
|
+
* @alpha
|
|
11
11
|
*/
|
|
12
12
|
export type TelemetryEventCategory = "generic" | "error" | "performance";
|
|
13
13
|
|
|
@@ -25,7 +25,7 @@ export type TelemetryBaseEventPropertyType = TelemetryEventPropertyType;
|
|
|
25
25
|
* {@inheritDoc TelemetryBaseEventPropertyType}
|
|
26
26
|
*
|
|
27
27
|
* @deprecated Renamed to {@link TelemetryBaseEventPropertyType}
|
|
28
|
-
* @
|
|
28
|
+
* @alpha
|
|
29
29
|
*/
|
|
30
30
|
export type TelemetryEventPropertyType = string | number | boolean | undefined;
|
|
31
31
|
|
|
@@ -35,7 +35,7 @@ export type TelemetryEventPropertyType = string | number | boolean | undefined;
|
|
|
35
35
|
*
|
|
36
36
|
* This indicates that the value should be organized or handled differently by loggers in various first or third
|
|
37
37
|
* party scenarios. For example, tags are used to mark data that should not be stored in logs for privacy reasons.
|
|
38
|
-
* @
|
|
38
|
+
* @alpha
|
|
39
39
|
*/
|
|
40
40
|
export interface Tagged<V, T extends string = string> {
|
|
41
41
|
value: V;
|
|
@@ -55,7 +55,7 @@ export interface ITaggedTelemetryPropertyType {
|
|
|
55
55
|
|
|
56
56
|
/**
|
|
57
57
|
* JSON-serializable properties, which will be logged with telemetry.
|
|
58
|
-
* @
|
|
58
|
+
* @alpha
|
|
59
59
|
*/
|
|
60
60
|
export type ITelemetryBaseProperties = ITelemetryProperties;
|
|
61
61
|
|
|
@@ -63,7 +63,7 @@ export type ITelemetryBaseProperties = ITelemetryProperties;
|
|
|
63
63
|
* {@inheritDoc ITelemetryBaseProperties}
|
|
64
64
|
*
|
|
65
65
|
* @deprecated Renamed to {@link ITelemetryBaseProperties}
|
|
66
|
-
* @
|
|
66
|
+
* @alpha
|
|
67
67
|
*/
|
|
68
68
|
export interface ITelemetryProperties {
|
|
69
69
|
[index: string]: TelemetryEventPropertyType | Tagged<TelemetryEventPropertyType>;
|
|
@@ -74,7 +74,7 @@ export interface ITelemetryProperties {
|
|
|
74
74
|
* Can contain any number of properties that get serialized as json payload.
|
|
75
75
|
* @param category - category of the event, like "error", "performance", "generic", etc.
|
|
76
76
|
* @param eventName - name of the event.
|
|
77
|
-
* @
|
|
77
|
+
* @alpha
|
|
78
78
|
*/
|
|
79
79
|
export interface ITelemetryBaseEvent extends ITelemetryBaseProperties {
|
|
80
80
|
category: string;
|
|
@@ -83,7 +83,7 @@ export interface ITelemetryBaseEvent extends ITelemetryBaseProperties {
|
|
|
83
83
|
|
|
84
84
|
/**
|
|
85
85
|
* Specify levels of the logs.
|
|
86
|
-
* @
|
|
86
|
+
* @alpha
|
|
87
87
|
*/
|
|
88
88
|
export const LogLevel = {
|
|
89
89
|
verbose: 10, // To log any verbose event for example when you are debugging something.
|
|
@@ -93,14 +93,14 @@ export const LogLevel = {
|
|
|
93
93
|
|
|
94
94
|
/**
|
|
95
95
|
* Specify a level to the log to filter out logs based on the level.
|
|
96
|
-
* @
|
|
96
|
+
* @alpha
|
|
97
97
|
*/
|
|
98
98
|
export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
|
|
99
99
|
|
|
100
100
|
/**
|
|
101
101
|
* Interface to output telemetry events.
|
|
102
102
|
* Implemented by hosting app / loader
|
|
103
|
-
* @
|
|
103
|
+
* @alpha
|
|
104
104
|
*/
|
|
105
105
|
export interface ITelemetryBaseLogger {
|
|
106
106
|
send(event: ITelemetryBaseEvent, logLevel?: LogLevel): void;
|
|
@@ -114,7 +114,7 @@ export interface ITelemetryBaseLogger {
|
|
|
114
114
|
*
|
|
115
115
|
* @deprecated For internal use within FluidFramework, use ITelemetryGenericEventExt in \@fluidframework/telemetry-utils.
|
|
116
116
|
* No replacement intended for FluidFramework consumers.
|
|
117
|
-
* @
|
|
117
|
+
* @alpha
|
|
118
118
|
*/
|
|
119
119
|
export interface ITelemetryGenericEvent extends ITelemetryProperties {
|
|
120
120
|
eventName: string;
|
|
@@ -127,7 +127,7 @@ export interface ITelemetryGenericEvent extends ITelemetryProperties {
|
|
|
127
127
|
*
|
|
128
128
|
* @deprecated For internal use within FluidFramework, use ITelemetryErrorEventExt in \@fluidframework/telemetry-utils.
|
|
129
129
|
* No replacement intended for FluidFramework consumers.
|
|
130
|
-
* @
|
|
130
|
+
* @alpha
|
|
131
131
|
*/
|
|
132
132
|
export interface ITelemetryErrorEvent extends ITelemetryProperties {
|
|
133
133
|
eventName: string;
|
|
@@ -139,7 +139,7 @@ export interface ITelemetryErrorEvent extends ITelemetryProperties {
|
|
|
139
139
|
*
|
|
140
140
|
* @deprecated For internal use within FluidFramework, use ITelemetryPerformanceEventExt in \@fluidframework/telemetry-utils.
|
|
141
141
|
* No replacement intended for FluidFramework consumers.
|
|
142
|
-
* @
|
|
142
|
+
* @alpha
|
|
143
143
|
*/
|
|
144
144
|
export interface ITelemetryPerformanceEvent extends ITelemetryGenericEvent {
|
|
145
145
|
duration?: number; // Duration of event (optional)
|
|
@@ -163,7 +163,7 @@ export interface ILoggingError extends Error {
|
|
|
163
163
|
*
|
|
164
164
|
* @deprecated For internal use within FluidFramework, use ITelemetryLoggerExt in \@fluidframework/telemetry-utils.
|
|
165
165
|
* No replacement intended for FluidFramework consumers.
|
|
166
|
-
* @
|
|
166
|
+
* @alpha
|
|
167
167
|
*/
|
|
168
168
|
export interface ITelemetryLogger extends ITelemetryBaseLogger {
|
|
169
169
|
/**
|
package/src/provider.ts
CHANGED
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
*
|
|
28
28
|
* This pattern enables discovery, and delegation in a standard way which is central
|
|
29
29
|
* to FluidObject pattern.
|
|
30
|
-
* @
|
|
30
|
+
* @alpha
|
|
31
31
|
*/
|
|
32
32
|
export type FluidObjectProviderKeys<T, TProp extends keyof T = keyof T> = string extends TProp
|
|
33
33
|
? never
|
|
@@ -70,7 +70,7 @@ export type FluidObjectProviderKeys<T, TProp extends keyof T = keyof T> = string
|
|
|
70
70
|
*
|
|
71
71
|
* You can inspect multiple types via a intersection. For example:
|
|
72
72
|
* `FluidObject<IFoo & IBar>`
|
|
73
|
-
* @
|
|
73
|
+
* @alpha
|
|
74
74
|
*/
|
|
75
75
|
export type FluidObject<T = unknown> = {
|
|
76
76
|
[P in FluidObjectProviderKeys<T>]?: T[P];
|
|
@@ -83,6 +83,6 @@ export type FluidObject<T = unknown> = {
|
|
|
83
83
|
* See {@link FluidObject}
|
|
84
84
|
*
|
|
85
85
|
* For example `FluidObjectKeys<IFoo & IBar>` would result in `"IFoo" | "IBar"`
|
|
86
|
-
* @
|
|
86
|
+
* @alpha
|
|
87
87
|
*/
|
|
88
88
|
export type FluidObjectKeys<T> = keyof FluidObject<T>;
|