@fluidframework/core-interfaces 2.0.0-dev.7.4.0.217212 → 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 +17 -17
- package/dist/config.d.ts +2 -2
- package/dist/config.js.map +1 -1
- package/dist/core-interfaces-alpha.d.ts +216 -14
- package/dist/core-interfaces-untrimmed.d.ts +17 -17
- package/dist/fluidLoadable.d.ts +3 -3
- package/dist/fluidLoadable.js +1 -1
- package/dist/fluidLoadable.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/logger.d.ts +5 -5
- package/dist/logger.js.map +1 -1
- package/dist/provider.d.ts +1 -1
- package/dist/provider.js.map +1 -1
- package/lib/config.d.ts +2 -2
- package/lib/config.js.map +1 -1
- package/lib/core-interfaces-alpha.d.ts +216 -14
- package/lib/core-interfaces-untrimmed.d.ts +17 -17
- package/lib/fluidLoadable.d.ts +3 -3
- package/lib/fluidLoadable.js +1 -1
- package/lib/fluidLoadable.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/logger.d.ts +5 -5
- package/lib/logger.js.map +1 -1
- package/lib/provider.d.ts +1 -1
- package/lib/provider.js.map +1 -1
- package/package.json +2 -2
- package/src/config.ts +2 -2
- package/src/fluidLoadable.ts +3 -3
- package/src/handles.ts +6 -6
- package/src/logger.ts +5 -5
- package/src/provider.ts +1 -1
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
```ts
|
|
6
6
|
|
|
7
|
-
// @
|
|
7
|
+
// @alpha
|
|
8
8
|
export type ConfigTypes = string | number | boolean | number[] | string[] | boolean[] | undefined;
|
|
9
9
|
|
|
10
10
|
// @alpha
|
|
@@ -27,13 +27,13 @@ export type FluidObject<T = unknown> = {
|
|
|
27
27
|
[P in FluidObjectProviderKeys<T>]?: T[P];
|
|
28
28
|
};
|
|
29
29
|
|
|
30
|
-
// @
|
|
30
|
+
// @alpha
|
|
31
31
|
export type FluidObjectKeys<T> = keyof FluidObject<T>;
|
|
32
32
|
|
|
33
33
|
// @alpha
|
|
34
34
|
export type FluidObjectProviderKeys<T, TProp extends keyof T = keyof T> = string extends TProp ? never : number extends TProp ? never : TProp extends keyof Required<T>[TProp] ? Required<T>[TProp] extends Required<Required<T>[TProp]>[TProp] ? TProp : never : never;
|
|
35
35
|
|
|
36
|
-
// @
|
|
36
|
+
// @alpha
|
|
37
37
|
export interface IConfigProviderBase {
|
|
38
38
|
getRawConfig(name: string): ConfigTypes;
|
|
39
39
|
}
|
|
@@ -251,10 +251,10 @@ export interface IFluidCodeDetailsConfig {
|
|
|
251
251
|
readonly [key: string]: string;
|
|
252
252
|
}
|
|
253
253
|
|
|
254
|
-
// @
|
|
254
|
+
// @alpha (undocumented)
|
|
255
255
|
export const IFluidHandle: keyof IProvideFluidHandle;
|
|
256
256
|
|
|
257
|
-
// @
|
|
257
|
+
// @alpha
|
|
258
258
|
export interface IFluidHandle<T = FluidObject & IFluidLoadable> extends IProvideFluidHandle {
|
|
259
259
|
// @deprecated (undocumented)
|
|
260
260
|
readonly absolutePath: string;
|
|
@@ -266,10 +266,10 @@ export interface IFluidHandle<T = FluidObject & IFluidLoadable> extends IProvide
|
|
|
266
266
|
readonly isAttached: boolean;
|
|
267
267
|
}
|
|
268
268
|
|
|
269
|
-
// @
|
|
269
|
+
// @alpha (undocumented)
|
|
270
270
|
export const IFluidHandleContext: keyof IProvideFluidHandleContext;
|
|
271
271
|
|
|
272
|
-
// @
|
|
272
|
+
// @alpha
|
|
273
273
|
export interface IFluidHandleContext extends IProvideFluidHandleContext {
|
|
274
274
|
readonly absolutePath: string;
|
|
275
275
|
attachGraph(): void;
|
|
@@ -279,10 +279,10 @@ export interface IFluidHandleContext extends IProvideFluidHandleContext {
|
|
|
279
279
|
readonly routeContext?: IFluidHandleContext;
|
|
280
280
|
}
|
|
281
281
|
|
|
282
|
-
// @
|
|
282
|
+
// @alpha (undocumented)
|
|
283
283
|
export const IFluidLoadable: keyof IProvideFluidLoadable;
|
|
284
284
|
|
|
285
|
-
// @
|
|
285
|
+
// @alpha
|
|
286
286
|
export interface IFluidLoadable extends IProvideFluidLoadable {
|
|
287
287
|
// (undocumented)
|
|
288
288
|
handle: IFluidHandle;
|
|
@@ -343,19 +343,19 @@ export interface IProvideFluidCodeDetailsComparer {
|
|
|
343
343
|
readonly IFluidCodeDetailsComparer: IFluidCodeDetailsComparer;
|
|
344
344
|
}
|
|
345
345
|
|
|
346
|
-
// @
|
|
346
|
+
// @alpha (undocumented)
|
|
347
347
|
export interface IProvideFluidHandle {
|
|
348
348
|
// (undocumented)
|
|
349
349
|
readonly IFluidHandle: IFluidHandle;
|
|
350
350
|
}
|
|
351
351
|
|
|
352
|
-
// @
|
|
352
|
+
// @alpha (undocumented)
|
|
353
353
|
export interface IProvideFluidHandleContext {
|
|
354
354
|
// (undocumented)
|
|
355
355
|
readonly IFluidHandleContext: IFluidHandleContext;
|
|
356
356
|
}
|
|
357
357
|
|
|
358
|
-
// @
|
|
358
|
+
// @alpha (undocumented)
|
|
359
359
|
export interface IProvideFluidLoadable {
|
|
360
360
|
// (undocumented)
|
|
361
361
|
readonly IFluidLoadable: IFluidLoadable;
|
|
@@ -436,13 +436,13 @@ export interface ITelemetryBaseLogger {
|
|
|
436
436
|
// @alpha
|
|
437
437
|
export type ITelemetryBaseProperties = ITelemetryProperties;
|
|
438
438
|
|
|
439
|
-
// @
|
|
439
|
+
// @alpha @deprecated
|
|
440
440
|
export interface ITelemetryErrorEvent extends ITelemetryProperties {
|
|
441
441
|
// (undocumented)
|
|
442
442
|
eventName: string;
|
|
443
443
|
}
|
|
444
444
|
|
|
445
|
-
// @
|
|
445
|
+
// @alpha @deprecated
|
|
446
446
|
export interface ITelemetryGenericEvent extends ITelemetryProperties {
|
|
447
447
|
// (undocumented)
|
|
448
448
|
category?: TelemetryEventCategory;
|
|
@@ -450,7 +450,7 @@ export interface ITelemetryGenericEvent extends ITelemetryProperties {
|
|
|
450
450
|
eventName: string;
|
|
451
451
|
}
|
|
452
452
|
|
|
453
|
-
// @
|
|
453
|
+
// @alpha @deprecated
|
|
454
454
|
export interface ITelemetryLogger extends ITelemetryBaseLogger {
|
|
455
455
|
send(event: ITelemetryBaseEvent, logLevel?: LogLevel): void;
|
|
456
456
|
sendErrorEvent(event: ITelemetryErrorEvent, error?: any): void;
|
|
@@ -458,7 +458,7 @@ export interface ITelemetryLogger extends ITelemetryBaseLogger {
|
|
|
458
458
|
sendTelemetryEvent(event: ITelemetryGenericEvent, error?: any, logLevel?: typeof LogLevel.verbose | typeof LogLevel.default): void;
|
|
459
459
|
}
|
|
460
460
|
|
|
461
|
-
// @
|
|
461
|
+
// @alpha @deprecated
|
|
462
462
|
export interface ITelemetryPerformanceEvent extends ITelemetryGenericEvent {
|
|
463
463
|
// (undocumented)
|
|
464
464
|
duration?: number;
|
|
@@ -508,7 +508,7 @@ export interface Tagged<V, T extends string = string> {
|
|
|
508
508
|
// @internal
|
|
509
509
|
export type TelemetryBaseEventPropertyType = TelemetryEventPropertyType;
|
|
510
510
|
|
|
511
|
-
// @
|
|
511
|
+
// @alpha @deprecated
|
|
512
512
|
export type TelemetryEventCategory = "generic" | "error" | "performance";
|
|
513
513
|
|
|
514
514
|
// @alpha @deprecated
|
package/dist/config.d.ts
CHANGED
|
@@ -4,12 +4,12 @@
|
|
|
4
4
|
*/
|
|
5
5
|
/**
|
|
6
6
|
* Types supported by {@link IConfigProviderBase}.
|
|
7
|
-
* @
|
|
7
|
+
* @alpha
|
|
8
8
|
*/
|
|
9
9
|
export type ConfigTypes = string | number | boolean | number[] | string[] | boolean[] | undefined;
|
|
10
10
|
/**
|
|
11
11
|
* Base interface for providing configurations to enable/disable/control features.
|
|
12
|
-
* @
|
|
12
|
+
* @alpha
|
|
13
13
|
*/
|
|
14
14
|
export interface IConfigProviderBase {
|
|
15
15
|
/**
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Types supported by {@link IConfigProviderBase}.\n * @
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Types supported by {@link IConfigProviderBase}.\n * @alpha\n */\nexport type ConfigTypes = string | number | boolean | number[] | string[] | boolean[] | undefined;\n\n/**\n * Base interface for providing configurations to enable/disable/control features.\n * @alpha\n */\nexport interface IConfigProviderBase {\n\t/**\n\t * For the specified config name this function gets the value.\n\t *\n\t * This type is meant be easy to implement by Fluid Framework consumers\n\t * so the returned valued needs minimal type coercion, and allows consumers to\n\t * return values in a natural way from whatever source they retrieve them.\n\t *\n\t * For instance a value of 1 maybe be returned as a string or a number.\n\t * For array types a json string or an object are allowable.\n\t *\n\t * It should return undefined if there is no value available for the config name.\n\t *\n\t * @param name - The name of the config to get the value for.\n\t *\n\t * @privateRemarks Generally, this type should only be taken as input, and be wrapped by an\n\t * internal monitoring context from the fluidframework/telemetry-utils package. That will provide\n\t * a wrapper with provides strongly typed access to values via consistent type coercion.\n\t */\n\tgetRawConfig(name: string): ConfigTypes;\n}\n"]}
|
|
@@ -1,4 +1,8 @@
|
|
|
1
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Types supported by {@link IConfigProviderBase}.
|
|
3
|
+
* @alpha
|
|
4
|
+
*/
|
|
5
|
+
export declare type ConfigTypes = string | number | boolean | number[] | string[] | boolean[] | undefined;
|
|
2
6
|
|
|
3
7
|
/**
|
|
4
8
|
* Allows an interface to extend interfaces that already extend an {@link IEventProvider}.
|
|
@@ -65,7 +69,16 @@ export declare type FluidObject<T = unknown> = {
|
|
|
65
69
|
[P in FluidObjectProviderKeys<T>]?: T[P];
|
|
66
70
|
};
|
|
67
71
|
|
|
68
|
-
|
|
72
|
+
/**
|
|
73
|
+
* This utility type creates a type that is the union of all keys on the generic type
|
|
74
|
+
* which implement the FluidObject pattern.
|
|
75
|
+
*
|
|
76
|
+
* See {@link FluidObject}
|
|
77
|
+
*
|
|
78
|
+
* For example `FluidObjectKeys<IFoo & IBar>` would result in `"IFoo" | "IBar"`
|
|
79
|
+
* @alpha
|
|
80
|
+
*/
|
|
81
|
+
export declare type FluidObjectKeys<T> = keyof FluidObject<T>;
|
|
69
82
|
|
|
70
83
|
/**
|
|
71
84
|
* Produces a valid FluidObject key given a type and a property.
|
|
@@ -95,7 +108,31 @@ export declare type FluidObject<T = unknown> = {
|
|
|
95
108
|
*/
|
|
96
109
|
export declare type FluidObjectProviderKeys<T, TProp extends keyof T = keyof T> = string extends TProp ? never : number extends TProp ? never : TProp extends keyof Required<T>[TProp] ? Required<T>[TProp] extends Required<Required<T>[TProp]>[TProp] ? TProp : never : never;
|
|
97
110
|
|
|
98
|
-
|
|
111
|
+
/**
|
|
112
|
+
* Base interface for providing configurations to enable/disable/control features.
|
|
113
|
+
* @alpha
|
|
114
|
+
*/
|
|
115
|
+
export declare interface IConfigProviderBase {
|
|
116
|
+
/**
|
|
117
|
+
* For the specified config name this function gets the value.
|
|
118
|
+
*
|
|
119
|
+
* This type is meant be easy to implement by Fluid Framework consumers
|
|
120
|
+
* so the returned valued needs minimal type coercion, and allows consumers to
|
|
121
|
+
* return values in a natural way from whatever source they retrieve them.
|
|
122
|
+
*
|
|
123
|
+
* For instance a value of 1 maybe be returned as a string or a number.
|
|
124
|
+
* For array types a json string or an object are allowable.
|
|
125
|
+
*
|
|
126
|
+
* It should return undefined if there is no value available for the config name.
|
|
127
|
+
*
|
|
128
|
+
* @param name - The name of the config to get the value for.
|
|
129
|
+
*
|
|
130
|
+
* @privateRemarks Generally, this type should only be taken as input, and be wrapped by an
|
|
131
|
+
* internal monitoring context from the fluidframework/telemetry-utils package. That will provide
|
|
132
|
+
* a wrapper with provides strongly typed access to values via consistent type coercion.
|
|
133
|
+
*/
|
|
134
|
+
getRawConfig(name: string): ConfigTypes;
|
|
135
|
+
}
|
|
99
136
|
|
|
100
137
|
/**
|
|
101
138
|
* Base interface for objects that require lifetime management via explicit disposal.
|
|
@@ -388,11 +425,87 @@ export declare type IEventTransformer<TThis, TEvent extends IEvent> = TEvent ext
|
|
|
388
425
|
|
|
389
426
|
/* Excluded from this release type: IFluidCodeDetailsConfig */
|
|
390
427
|
|
|
391
|
-
|
|
428
|
+
/**
|
|
429
|
+
* @alpha
|
|
430
|
+
*/
|
|
431
|
+
export declare const IFluidHandle: keyof IProvideFluidHandle;
|
|
432
|
+
|
|
433
|
+
/**
|
|
434
|
+
* Handle to a shared {@link FluidObject}.
|
|
435
|
+
* @alpha
|
|
436
|
+
*/
|
|
437
|
+
export declare interface IFluidHandle<T = FluidObject & IFluidLoadable> extends IProvideFluidHandle {
|
|
438
|
+
/**
|
|
439
|
+
* @deprecated Do not use handle's path for routing. Use `get` to get the underlying object.
|
|
440
|
+
*
|
|
441
|
+
* The absolute path to the handle context from the root.
|
|
442
|
+
*/
|
|
443
|
+
readonly absolutePath: string;
|
|
444
|
+
/**
|
|
445
|
+
* Flag indicating whether or not the entity has services attached.
|
|
446
|
+
*/
|
|
447
|
+
readonly isAttached: boolean;
|
|
448
|
+
/**
|
|
449
|
+
* @deprecated To be removed. This is part of an internal API surface and should not be called.
|
|
450
|
+
*
|
|
451
|
+
* Runs through the graph and attach the bounded handles.
|
|
452
|
+
*/
|
|
453
|
+
attachGraph(): void;
|
|
454
|
+
/**
|
|
455
|
+
* Returns a promise to the Fluid Object referenced by the handle.
|
|
456
|
+
*/
|
|
457
|
+
get(): Promise<T>;
|
|
458
|
+
/**
|
|
459
|
+
* @deprecated To be removed. This is part of an internal API surface and should not be called.
|
|
460
|
+
*
|
|
461
|
+
* Binds the given handle to this one or attach the given handle if this handle is attached.
|
|
462
|
+
* A bound handle will also be attached once this handle is attached.
|
|
463
|
+
*/
|
|
464
|
+
bind(handle: IFluidHandle): void;
|
|
465
|
+
}
|
|
392
466
|
|
|
393
|
-
|
|
467
|
+
/**
|
|
468
|
+
* @alpha
|
|
469
|
+
*/
|
|
470
|
+
export declare const IFluidHandleContext: keyof IProvideFluidHandleContext;
|
|
394
471
|
|
|
395
|
-
|
|
472
|
+
/**
|
|
473
|
+
* Describes a routing context from which other `IFluidHandleContext`s are defined.
|
|
474
|
+
* @alpha
|
|
475
|
+
*/
|
|
476
|
+
export declare interface IFluidHandleContext extends IProvideFluidHandleContext {
|
|
477
|
+
/**
|
|
478
|
+
* The absolute path to the handle context from the root.
|
|
479
|
+
*/
|
|
480
|
+
readonly absolutePath: string;
|
|
481
|
+
/**
|
|
482
|
+
* The parent IFluidHandleContext that has provided a route path to this IFluidHandleContext or undefined
|
|
483
|
+
* at the root.
|
|
484
|
+
*/
|
|
485
|
+
readonly routeContext?: IFluidHandleContext;
|
|
486
|
+
/**
|
|
487
|
+
* Flag indicating whether or not the entity has services attached.
|
|
488
|
+
*/
|
|
489
|
+
readonly isAttached: boolean;
|
|
490
|
+
/**
|
|
491
|
+
* Runs through the graph and attach the bounded handles.
|
|
492
|
+
*/
|
|
493
|
+
attachGraph(): void;
|
|
494
|
+
resolveHandle(request: IRequest): Promise<IResponse>;
|
|
495
|
+
}
|
|
496
|
+
|
|
497
|
+
/**
|
|
498
|
+
* @alpha
|
|
499
|
+
*/
|
|
500
|
+
export declare const IFluidLoadable: keyof IProvideFluidLoadable;
|
|
501
|
+
|
|
502
|
+
/**
|
|
503
|
+
* A shared FluidObject has a URL from which it can be referenced
|
|
504
|
+
* @alpha
|
|
505
|
+
*/
|
|
506
|
+
export declare interface IFluidLoadable extends IProvideFluidLoadable {
|
|
507
|
+
handle: IFluidHandle;
|
|
508
|
+
}
|
|
396
509
|
|
|
397
510
|
/* Excluded from this release type: IFluidPackage */
|
|
398
511
|
|
|
@@ -420,11 +533,26 @@ export declare interface IFluidRouter extends IProvideFluidRouter {
|
|
|
420
533
|
|
|
421
534
|
/* Excluded from this release type: IProvideFluidCodeDetailsComparer */
|
|
422
535
|
|
|
423
|
-
|
|
536
|
+
/**
|
|
537
|
+
* @alpha
|
|
538
|
+
*/
|
|
539
|
+
export declare interface IProvideFluidHandle {
|
|
540
|
+
readonly IFluidHandle: IFluidHandle;
|
|
541
|
+
}
|
|
424
542
|
|
|
425
|
-
|
|
543
|
+
/**
|
|
544
|
+
* @alpha
|
|
545
|
+
*/
|
|
546
|
+
export declare interface IProvideFluidHandleContext {
|
|
547
|
+
readonly IFluidHandleContext: IFluidHandleContext;
|
|
548
|
+
}
|
|
426
549
|
|
|
427
|
-
|
|
550
|
+
/**
|
|
551
|
+
* @alpha
|
|
552
|
+
*/
|
|
553
|
+
export declare interface IProvideFluidLoadable {
|
|
554
|
+
readonly IFluidLoadable: IFluidLoadable;
|
|
555
|
+
}
|
|
428
556
|
|
|
429
557
|
/**
|
|
430
558
|
* Request routing
|
|
@@ -499,13 +627,81 @@ export declare interface ITelemetryBaseLogger {
|
|
|
499
627
|
*/
|
|
500
628
|
export declare type ITelemetryBaseProperties = ITelemetryProperties;
|
|
501
629
|
|
|
502
|
-
|
|
630
|
+
/**
|
|
631
|
+
* Error telemetry event.
|
|
632
|
+
* Maps to category = "error"
|
|
633
|
+
*
|
|
634
|
+
* @deprecated For internal use within FluidFramework, use ITelemetryErrorEventExt in \@fluidframework/telemetry-utils.
|
|
635
|
+
* No replacement intended for FluidFramework consumers.
|
|
636
|
+
* @alpha
|
|
637
|
+
*/
|
|
638
|
+
export declare interface ITelemetryErrorEvent extends ITelemetryProperties {
|
|
639
|
+
eventName: string;
|
|
640
|
+
}
|
|
503
641
|
|
|
504
|
-
|
|
642
|
+
/**
|
|
643
|
+
* Informational (non-error) telemetry event
|
|
644
|
+
* Maps to category = "generic"
|
|
645
|
+
*
|
|
646
|
+
* @deprecated For internal use within FluidFramework, use ITelemetryGenericEventExt in \@fluidframework/telemetry-utils.
|
|
647
|
+
* No replacement intended for FluidFramework consumers.
|
|
648
|
+
* @alpha
|
|
649
|
+
*/
|
|
650
|
+
export declare interface ITelemetryGenericEvent extends ITelemetryProperties {
|
|
651
|
+
eventName: string;
|
|
652
|
+
category?: TelemetryEventCategory;
|
|
653
|
+
}
|
|
505
654
|
|
|
506
|
-
|
|
655
|
+
/**
|
|
656
|
+
* ITelemetryLogger interface contains various helper telemetry methods,
|
|
657
|
+
* encoding in one place schemas for various types of Fluid telemetry events.
|
|
658
|
+
* Creates sub-logger that appends properties to all events
|
|
659
|
+
*
|
|
660
|
+
* @deprecated For internal use within FluidFramework, use ITelemetryLoggerExt in \@fluidframework/telemetry-utils.
|
|
661
|
+
* No replacement intended for FluidFramework consumers.
|
|
662
|
+
* @alpha
|
|
663
|
+
*/
|
|
664
|
+
export declare interface ITelemetryLogger extends ITelemetryBaseLogger {
|
|
665
|
+
/**
|
|
666
|
+
* Actual implementation that sends telemetry event
|
|
667
|
+
* Implemented by derived classes
|
|
668
|
+
* @param event - Telemetry event to send over
|
|
669
|
+
* @param logLevel - optional level of the log.
|
|
670
|
+
*/
|
|
671
|
+
send(event: ITelemetryBaseEvent, logLevel?: LogLevel): void;
|
|
672
|
+
/**
|
|
673
|
+
* Send information telemetry event
|
|
674
|
+
* @param event - Event to send
|
|
675
|
+
* @param error - optional error object to log
|
|
676
|
+
* @param logLevel - optional level of the log.
|
|
677
|
+
*/
|
|
678
|
+
sendTelemetryEvent(event: ITelemetryGenericEvent, error?: any, logLevel?: typeof LogLevel.verbose | typeof LogLevel.default): void;
|
|
679
|
+
/**
|
|
680
|
+
* Send error telemetry event
|
|
681
|
+
* @param event - Event to send
|
|
682
|
+
* @param error - optional error object to log
|
|
683
|
+
*/
|
|
684
|
+
sendErrorEvent(event: ITelemetryErrorEvent, error?: any): void;
|
|
685
|
+
/**
|
|
686
|
+
* Send performance telemetry event
|
|
687
|
+
* @param event - Event to send
|
|
688
|
+
* @param error - optional error object to log
|
|
689
|
+
* @param logLevel - optional level of the log.
|
|
690
|
+
*/
|
|
691
|
+
sendPerformanceEvent(event: ITelemetryPerformanceEvent, error?: any, logLevel?: typeof LogLevel.verbose | typeof LogLevel.default): void;
|
|
692
|
+
}
|
|
507
693
|
|
|
508
|
-
|
|
694
|
+
/**
|
|
695
|
+
* Performance telemetry event.
|
|
696
|
+
* Maps to category = "performance"
|
|
697
|
+
*
|
|
698
|
+
* @deprecated For internal use within FluidFramework, use ITelemetryPerformanceEventExt in \@fluidframework/telemetry-utils.
|
|
699
|
+
* No replacement intended for FluidFramework consumers.
|
|
700
|
+
* @alpha
|
|
701
|
+
*/
|
|
702
|
+
export declare interface ITelemetryPerformanceEvent extends ITelemetryGenericEvent {
|
|
703
|
+
duration?: number;
|
|
704
|
+
}
|
|
509
705
|
|
|
510
706
|
/**
|
|
511
707
|
* {@inheritDoc ITelemetryBaseProperties}
|
|
@@ -560,7 +756,13 @@ export declare interface Tagged<V, T extends string = string> {
|
|
|
560
756
|
|
|
561
757
|
/* Excluded from this release type: TelemetryBaseEventPropertyType */
|
|
562
758
|
|
|
563
|
-
|
|
759
|
+
/**
|
|
760
|
+
* Examples of known categories, however category can be any string for extensibility.
|
|
761
|
+
*
|
|
762
|
+
* @deprecated Moved to \@fluidframework/telemetry-utils package
|
|
763
|
+
* @alpha
|
|
764
|
+
*/
|
|
765
|
+
export declare type TelemetryEventCategory = "generic" | "error" | "performance";
|
|
564
766
|
|
|
565
767
|
/**
|
|
566
768
|
* {@inheritDoc TelemetryBaseEventPropertyType}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Types supported by {@link IConfigProviderBase}.
|
|
3
|
-
* @
|
|
3
|
+
* @alpha
|
|
4
4
|
*/
|
|
5
5
|
export declare type ConfigTypes = string | number | boolean | number[] | string[] | boolean[] | undefined;
|
|
6
6
|
|
|
@@ -106,7 +106,7 @@ export declare type FluidObject<T = unknown> = {
|
|
|
106
106
|
* See {@link FluidObject}
|
|
107
107
|
*
|
|
108
108
|
* For example `FluidObjectKeys<IFoo & IBar>` would result in `"IFoo" | "IBar"`
|
|
109
|
-
* @
|
|
109
|
+
* @alpha
|
|
110
110
|
*/
|
|
111
111
|
export declare type FluidObjectKeys<T> = keyof FluidObject<T>;
|
|
112
112
|
|
|
@@ -140,7 +140,7 @@ export declare type FluidObjectProviderKeys<T, TProp extends keyof T = keyof T>
|
|
|
140
140
|
|
|
141
141
|
/**
|
|
142
142
|
* Base interface for providing configurations to enable/disable/control features.
|
|
143
|
-
* @
|
|
143
|
+
* @alpha
|
|
144
144
|
*/
|
|
145
145
|
export declare interface IConfigProviderBase {
|
|
146
146
|
/**
|
|
@@ -519,13 +519,13 @@ export declare interface IFluidCodeDetailsConfig {
|
|
|
519
519
|
}
|
|
520
520
|
|
|
521
521
|
/**
|
|
522
|
-
* @
|
|
522
|
+
* @alpha
|
|
523
523
|
*/
|
|
524
524
|
export declare const IFluidHandle: keyof IProvideFluidHandle;
|
|
525
525
|
|
|
526
526
|
/**
|
|
527
527
|
* Handle to a shared {@link FluidObject}.
|
|
528
|
-
* @
|
|
528
|
+
* @alpha
|
|
529
529
|
*/
|
|
530
530
|
export declare interface IFluidHandle<T = FluidObject & IFluidLoadable> extends IProvideFluidHandle {
|
|
531
531
|
/**
|
|
@@ -558,13 +558,13 @@ export declare interface IFluidHandle<T = FluidObject & IFluidLoadable> extends
|
|
|
558
558
|
}
|
|
559
559
|
|
|
560
560
|
/**
|
|
561
|
-
* @
|
|
561
|
+
* @alpha
|
|
562
562
|
*/
|
|
563
563
|
export declare const IFluidHandleContext: keyof IProvideFluidHandleContext;
|
|
564
564
|
|
|
565
565
|
/**
|
|
566
566
|
* Describes a routing context from which other `IFluidHandleContext`s are defined.
|
|
567
|
-
* @
|
|
567
|
+
* @alpha
|
|
568
568
|
*/
|
|
569
569
|
export declare interface IFluidHandleContext extends IProvideFluidHandleContext {
|
|
570
570
|
/**
|
|
@@ -588,13 +588,13 @@ export declare interface IFluidHandleContext extends IProvideFluidHandleContext
|
|
|
588
588
|
}
|
|
589
589
|
|
|
590
590
|
/**
|
|
591
|
-
* @
|
|
591
|
+
* @alpha
|
|
592
592
|
*/
|
|
593
593
|
export declare const IFluidLoadable: keyof IProvideFluidLoadable;
|
|
594
594
|
|
|
595
595
|
/**
|
|
596
596
|
* A shared FluidObject has a URL from which it can be referenced
|
|
597
|
-
* @
|
|
597
|
+
* @alpha
|
|
598
598
|
*/
|
|
599
599
|
export declare interface IFluidLoadable extends IProvideFluidLoadable {
|
|
600
600
|
handle: IFluidHandle;
|
|
@@ -721,21 +721,21 @@ export declare interface IProvideFluidCodeDetailsComparer {
|
|
|
721
721
|
}
|
|
722
722
|
|
|
723
723
|
/**
|
|
724
|
-
* @
|
|
724
|
+
* @alpha
|
|
725
725
|
*/
|
|
726
726
|
export declare interface IProvideFluidHandle {
|
|
727
727
|
readonly IFluidHandle: IFluidHandle;
|
|
728
728
|
}
|
|
729
729
|
|
|
730
730
|
/**
|
|
731
|
-
* @
|
|
731
|
+
* @alpha
|
|
732
732
|
*/
|
|
733
733
|
export declare interface IProvideFluidHandleContext {
|
|
734
734
|
readonly IFluidHandleContext: IFluidHandleContext;
|
|
735
735
|
}
|
|
736
736
|
|
|
737
737
|
/**
|
|
738
|
-
* @
|
|
738
|
+
* @alpha
|
|
739
739
|
*/
|
|
740
740
|
export declare interface IProvideFluidLoadable {
|
|
741
741
|
readonly IFluidLoadable: IFluidLoadable;
|
|
@@ -848,7 +848,7 @@ export declare type ITelemetryBaseProperties = ITelemetryProperties;
|
|
|
848
848
|
*
|
|
849
849
|
* @deprecated For internal use within FluidFramework, use ITelemetryErrorEventExt in \@fluidframework/telemetry-utils.
|
|
850
850
|
* No replacement intended for FluidFramework consumers.
|
|
851
|
-
* @
|
|
851
|
+
* @alpha
|
|
852
852
|
*/
|
|
853
853
|
export declare interface ITelemetryErrorEvent extends ITelemetryProperties {
|
|
854
854
|
eventName: string;
|
|
@@ -860,7 +860,7 @@ export declare interface ITelemetryErrorEvent extends ITelemetryProperties {
|
|
|
860
860
|
*
|
|
861
861
|
* @deprecated For internal use within FluidFramework, use ITelemetryGenericEventExt in \@fluidframework/telemetry-utils.
|
|
862
862
|
* No replacement intended for FluidFramework consumers.
|
|
863
|
-
* @
|
|
863
|
+
* @alpha
|
|
864
864
|
*/
|
|
865
865
|
export declare interface ITelemetryGenericEvent extends ITelemetryProperties {
|
|
866
866
|
eventName: string;
|
|
@@ -874,7 +874,7 @@ export declare interface ITelemetryGenericEvent extends ITelemetryProperties {
|
|
|
874
874
|
*
|
|
875
875
|
* @deprecated For internal use within FluidFramework, use ITelemetryLoggerExt in \@fluidframework/telemetry-utils.
|
|
876
876
|
* No replacement intended for FluidFramework consumers.
|
|
877
|
-
* @
|
|
877
|
+
* @alpha
|
|
878
878
|
*/
|
|
879
879
|
export declare interface ITelemetryLogger extends ITelemetryBaseLogger {
|
|
880
880
|
/**
|
|
@@ -912,7 +912,7 @@ export declare interface ITelemetryLogger extends ITelemetryBaseLogger {
|
|
|
912
912
|
*
|
|
913
913
|
* @deprecated For internal use within FluidFramework, use ITelemetryPerformanceEventExt in \@fluidframework/telemetry-utils.
|
|
914
914
|
* No replacement intended for FluidFramework consumers.
|
|
915
|
-
* @
|
|
915
|
+
* @alpha
|
|
916
916
|
*/
|
|
917
917
|
export declare interface ITelemetryPerformanceEvent extends ITelemetryGenericEvent {
|
|
918
918
|
duration?: number;
|
|
@@ -1002,7 +1002,7 @@ export declare type TelemetryBaseEventPropertyType = TelemetryEventPropertyType;
|
|
|
1002
1002
|
* Examples of known categories, however category can be any string for extensibility.
|
|
1003
1003
|
*
|
|
1004
1004
|
* @deprecated Moved to \@fluidframework/telemetry-utils package
|
|
1005
|
-
* @
|
|
1005
|
+
* @alpha
|
|
1006
1006
|
*/
|
|
1007
1007
|
export declare type TelemetryEventCategory = "generic" | "error" | "performance";
|
|
1008
1008
|
|
package/dist/fluidLoadable.d.ts
CHANGED
|
@@ -4,18 +4,18 @@
|
|
|
4
4
|
*/
|
|
5
5
|
import { IFluidHandle } from "./handles";
|
|
6
6
|
/**
|
|
7
|
-
* @
|
|
7
|
+
* @alpha
|
|
8
8
|
*/
|
|
9
9
|
export declare const IFluidLoadable: keyof IProvideFluidLoadable;
|
|
10
10
|
/**
|
|
11
|
-
* @
|
|
11
|
+
* @alpha
|
|
12
12
|
*/
|
|
13
13
|
export interface IProvideFluidLoadable {
|
|
14
14
|
readonly IFluidLoadable: IFluidLoadable;
|
|
15
15
|
}
|
|
16
16
|
/**
|
|
17
17
|
* A shared FluidObject has a URL from which it can be referenced
|
|
18
|
-
* @
|
|
18
|
+
* @alpha
|
|
19
19
|
*/
|
|
20
20
|
export interface IFluidLoadable extends IProvideFluidLoadable {
|
|
21
21
|
handle: IFluidHandle;
|
package/dist/fluidLoadable.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fluidLoadable.js","sourceRoot":"","sources":["../src/fluidLoadable.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH;;GAEG;AACU,QAAA,cAAc,GAAgC,gBAAgB,CAAC;AAiB5E;;GAEG;AACU,QAAA,cAAc,GAAgC,gBAAgB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IFluidHandle } from \"./handles\";\n\n/**\n * @
|
|
1
|
+
{"version":3,"file":"fluidLoadable.js","sourceRoot":"","sources":["../src/fluidLoadable.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH;;GAEG;AACU,QAAA,cAAc,GAAgC,gBAAgB,CAAC;AAiB5E;;GAEG;AACU,QAAA,cAAc,GAAgC,gBAAgB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IFluidHandle } from \"./handles\";\n\n/**\n * @alpha\n */\nexport const IFluidLoadable: keyof IProvideFluidLoadable = \"IFluidLoadable\";\n\n/**\n * @alpha\n */\nexport interface IProvideFluidLoadable {\n\treadonly IFluidLoadable: IFluidLoadable;\n}\n/**\n * A shared FluidObject has a URL from which it can be referenced\n * @alpha\n */\nexport interface IFluidLoadable extends IProvideFluidLoadable {\n\t// Handle to the loadable FluidObject\n\thandle: IFluidHandle;\n}\n\n/**\n * @internal\n */\nexport const IFluidRunnable: keyof IProvideFluidRunnable = \"IFluidRunnable\";\n\n/**\n * @internal\n */\nexport interface IProvideFluidRunnable {\n\treadonly IFluidRunnable: IFluidRunnable;\n}\n/**\n * @internal\n */\nexport interface IFluidRunnable {\n\t// TODO: Use `unknown` instead (API-Breaking)\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\trun(...args: any[]): Promise<void>;\n\tstop(reason?: string): void;\n}\n"]}
|
package/dist/handles.d.ts
CHANGED
|
@@ -6,18 +6,18 @@ import { IRequest, IResponse } from "./fluidRouter";
|
|
|
6
6
|
import { IFluidLoadable } from "./fluidLoadable";
|
|
7
7
|
import { FluidObject } from "./provider";
|
|
8
8
|
/**
|
|
9
|
-
* @
|
|
9
|
+
* @alpha
|
|
10
10
|
*/
|
|
11
11
|
export declare const IFluidHandleContext: keyof IProvideFluidHandleContext;
|
|
12
12
|
/**
|
|
13
|
-
* @
|
|
13
|
+
* @alpha
|
|
14
14
|
*/
|
|
15
15
|
export interface IProvideFluidHandleContext {
|
|
16
16
|
readonly IFluidHandleContext: IFluidHandleContext;
|
|
17
17
|
}
|
|
18
18
|
/**
|
|
19
19
|
* Describes a routing context from which other `IFluidHandleContext`s are defined.
|
|
20
|
-
* @
|
|
20
|
+
* @alpha
|
|
21
21
|
*/
|
|
22
22
|
export interface IFluidHandleContext extends IProvideFluidHandleContext {
|
|
23
23
|
/**
|
|
@@ -40,18 +40,18 @@ export interface IFluidHandleContext extends IProvideFluidHandleContext {
|
|
|
40
40
|
resolveHandle(request: IRequest): Promise<IResponse>;
|
|
41
41
|
}
|
|
42
42
|
/**
|
|
43
|
-
* @
|
|
43
|
+
* @alpha
|
|
44
44
|
*/
|
|
45
45
|
export declare const IFluidHandle: keyof IProvideFluidHandle;
|
|
46
46
|
/**
|
|
47
|
-
* @
|
|
47
|
+
* @alpha
|
|
48
48
|
*/
|
|
49
49
|
export interface IProvideFluidHandle {
|
|
50
50
|
readonly IFluidHandle: IFluidHandle;
|
|
51
51
|
}
|
|
52
52
|
/**
|
|
53
53
|
* Handle to a shared {@link FluidObject}.
|
|
54
|
-
* @
|
|
54
|
+
* @alpha
|
|
55
55
|
*/
|
|
56
56
|
export interface IFluidHandle<T = FluidObject & IFluidLoadable> extends IProvideFluidHandle {
|
|
57
57
|
/**
|
package/dist/handles.js
CHANGED
|
@@ -6,11 +6,11 @@
|
|
|
6
6
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
7
|
exports.IFluidHandle = exports.IFluidHandleContext = void 0;
|
|
8
8
|
/**
|
|
9
|
-
* @
|
|
9
|
+
* @alpha
|
|
10
10
|
*/
|
|
11
11
|
exports.IFluidHandleContext = "IFluidHandleContext";
|
|
12
12
|
/**
|
|
13
|
-
* @
|
|
13
|
+
* @alpha
|
|
14
14
|
*/
|
|
15
15
|
exports.IFluidHandle = "IFluidHandle";
|
|
16
16
|
//# sourceMappingURL=handles.js.map
|