@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.
@@ -4,7 +4,7 @@
4
4
 
5
5
  ```ts
6
6
 
7
- // @internal
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
- // @internal
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
- // @internal
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
- // @internal (undocumented)
254
+ // @alpha (undocumented)
255
255
  export const IFluidHandle: keyof IProvideFluidHandle;
256
256
 
257
- // @internal
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
- // @internal (undocumented)
269
+ // @alpha (undocumented)
270
270
  export const IFluidHandleContext: keyof IProvideFluidHandleContext;
271
271
 
272
- // @internal
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
- // @internal (undocumented)
282
+ // @alpha (undocumented)
283
283
  export const IFluidLoadable: keyof IProvideFluidLoadable;
284
284
 
285
- // @internal
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
- // @internal (undocumented)
346
+ // @alpha (undocumented)
347
347
  export interface IProvideFluidHandle {
348
348
  // (undocumented)
349
349
  readonly IFluidHandle: IFluidHandle;
350
350
  }
351
351
 
352
- // @internal (undocumented)
352
+ // @alpha (undocumented)
353
353
  export interface IProvideFluidHandleContext {
354
354
  // (undocumented)
355
355
  readonly IFluidHandleContext: IFluidHandleContext;
356
356
  }
357
357
 
358
- // @internal (undocumented)
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
- // @internal @deprecated
439
+ // @alpha @deprecated
440
440
  export interface ITelemetryErrorEvent extends ITelemetryProperties {
441
441
  // (undocumented)
442
442
  eventName: string;
443
443
  }
444
444
 
445
- // @internal @deprecated
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
- // @internal @deprecated
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
- // @internal @deprecated
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
- // @internal @deprecated
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
- * @internal
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
- * @internal
12
+ * @alpha
13
13
  */
14
14
  export interface IConfigProviderBase {
15
15
  /**
@@ -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 * @internal\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 * @internal\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
+ {"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
- /* Excluded from this release type: ConfigTypes */
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
- /* Excluded from this release type: FluidObjectKeys */
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
- /* Excluded from this release type: IConfigProviderBase */
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
- /* Excluded from this release type: IFluidHandle */
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
- /* Excluded from this release type: IFluidHandleContext */
467
+ /**
468
+ * @alpha
469
+ */
470
+ export declare const IFluidHandleContext: keyof IProvideFluidHandleContext;
394
471
 
395
- /* Excluded from this release type: IFluidLoadable */
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
- /* Excluded from this release type: IProvideFluidHandle */
536
+ /**
537
+ * @alpha
538
+ */
539
+ export declare interface IProvideFluidHandle {
540
+ readonly IFluidHandle: IFluidHandle;
541
+ }
424
542
 
425
- /* Excluded from this release type: IProvideFluidHandleContext */
543
+ /**
544
+ * @alpha
545
+ */
546
+ export declare interface IProvideFluidHandleContext {
547
+ readonly IFluidHandleContext: IFluidHandleContext;
548
+ }
426
549
 
427
- /* Excluded from this release type: IProvideFluidLoadable */
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
- /* Excluded from this release type: ITelemetryErrorEvent */
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
- /* Excluded from this release type: ITelemetryGenericEvent */
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
- /* Excluded from this release type: ITelemetryLogger */
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
- /* Excluded from this release type: ITelemetryPerformanceEvent */
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
- /* Excluded from this release type: TelemetryEventCategory */
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
724
+ * @alpha
725
725
  */
726
726
  export declare interface IProvideFluidHandle {
727
727
  readonly IFluidHandle: IFluidHandle;
728
728
  }
729
729
 
730
730
  /**
731
- * @internal
731
+ * @alpha
732
732
  */
733
733
  export declare interface IProvideFluidHandleContext {
734
734
  readonly IFluidHandleContext: IFluidHandleContext;
735
735
  }
736
736
 
737
737
  /**
738
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
1005
+ * @alpha
1006
1006
  */
1007
1007
  export declare type TelemetryEventCategory = "generic" | "error" | "performance";
1008
1008
 
@@ -4,18 +4,18 @@
4
4
  */
5
5
  import { IFluidHandle } from "./handles";
6
6
  /**
7
- * @internal
7
+ * @alpha
8
8
  */
9
9
  export declare const IFluidLoadable: keyof IProvideFluidLoadable;
10
10
  /**
11
- * @internal
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
- * @internal
18
+ * @alpha
19
19
  */
20
20
  export interface IFluidLoadable extends IProvideFluidLoadable {
21
21
  handle: IFluidHandle;
@@ -6,7 +6,7 @@
6
6
  Object.defineProperty(exports, "__esModule", { value: true });
7
7
  exports.IFluidRunnable = exports.IFluidLoadable = void 0;
8
8
  /**
9
- * @internal
9
+ * @alpha
10
10
  */
11
11
  exports.IFluidLoadable = "IFluidLoadable";
12
12
  /**
@@ -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 * @internal\n */\nexport const IFluidLoadable: keyof IProvideFluidLoadable = \"IFluidLoadable\";\n\n/**\n * @internal\n */\nexport interface IProvideFluidLoadable {\n\treadonly IFluidLoadable: IFluidLoadable;\n}\n/**\n * A shared FluidObject has a URL from which it can be referenced\n * @internal\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"]}
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
- * @internal
9
+ * @alpha
10
10
  */
11
11
  export declare const IFluidHandleContext: keyof IProvideFluidHandleContext;
12
12
  /**
13
- * @internal
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
- * @internal
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
- * @internal
43
+ * @alpha
44
44
  */
45
45
  export declare const IFluidHandle: keyof IProvideFluidHandle;
46
46
  /**
47
- * @internal
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
- * @internal
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
- * @internal
9
+ * @alpha
10
10
  */
11
11
  exports.IFluidHandleContext = "IFluidHandleContext";
12
12
  /**
13
- * @internal
13
+ * @alpha
14
14
  */
15
15
  exports.IFluidHandle = "IFluidHandle";
16
16
  //# sourceMappingURL=handles.js.map