@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.
Files changed (76) hide show
  1. package/api-report/core-interfaces.api.md +49 -41
  2. package/dist/config.d.ts +35 -0
  3. package/dist/config.d.ts.map +1 -0
  4. package/dist/config.js +7 -0
  5. package/dist/config.js.map +1 -0
  6. package/dist/core-interfaces-alpha.d.ts +738 -63
  7. package/dist/core-interfaces-beta.d.ts +4 -0
  8. package/dist/core-interfaces-public.d.ts +4 -0
  9. package/dist/core-interfaces-untrimmed.d.ts +74 -41
  10. package/dist/disposable.d.ts +1 -1
  11. package/dist/disposable.js.map +1 -1
  12. package/dist/error.d.ts +2 -1
  13. package/dist/error.d.ts.map +1 -1
  14. package/dist/error.js.map +1 -1
  15. package/dist/events.d.ts +8 -8
  16. package/dist/events.js.map +1 -1
  17. package/dist/fluidLoadable.d.ts +3 -3
  18. package/dist/fluidLoadable.js +1 -1
  19. package/dist/fluidLoadable.js.map +1 -1
  20. package/dist/fluidRouter.d.ts +6 -6
  21. package/dist/fluidRouter.js +1 -1
  22. package/dist/fluidRouter.js.map +1 -1
  23. package/dist/handles.d.ts +6 -6
  24. package/dist/handles.js +2 -2
  25. package/dist/handles.js.map +1 -1
  26. package/dist/index.d.ts +1 -0
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js.map +1 -1
  29. package/dist/logger.d.ts +13 -13
  30. package/dist/logger.js +1 -1
  31. package/dist/logger.js.map +1 -1
  32. package/dist/provider.d.ts +3 -3
  33. package/dist/provider.js.map +1 -1
  34. package/lib/config.d.ts +35 -0
  35. package/lib/config.d.ts.map +1 -0
  36. package/lib/config.js +6 -0
  37. package/lib/config.js.map +1 -0
  38. package/lib/core-interfaces-alpha.d.ts +738 -63
  39. package/lib/core-interfaces-beta.d.ts +4 -0
  40. package/lib/core-interfaces-public.d.ts +4 -0
  41. package/lib/core-interfaces-untrimmed.d.ts +74 -41
  42. package/lib/disposable.d.ts +1 -1
  43. package/lib/disposable.js.map +1 -1
  44. package/lib/error.d.ts +2 -1
  45. package/lib/error.d.ts.map +1 -1
  46. package/lib/error.js.map +1 -1
  47. package/lib/events.d.ts +8 -8
  48. package/lib/events.js.map +1 -1
  49. package/lib/fluidLoadable.d.ts +3 -3
  50. package/lib/fluidLoadable.js +1 -1
  51. package/lib/fluidLoadable.js.map +1 -1
  52. package/lib/fluidRouter.d.ts +6 -6
  53. package/lib/fluidRouter.js +1 -1
  54. package/lib/fluidRouter.js.map +1 -1
  55. package/lib/handles.d.ts +6 -6
  56. package/lib/handles.js +2 -2
  57. package/lib/handles.js.map +1 -1
  58. package/lib/index.d.ts +1 -0
  59. package/lib/index.d.ts.map +1 -1
  60. package/lib/index.js.map +1 -1
  61. package/lib/logger.d.ts +13 -13
  62. package/lib/logger.js +1 -1
  63. package/lib/logger.js.map +1 -1
  64. package/lib/provider.d.ts +3 -3
  65. package/lib/provider.js.map +1 -1
  66. package/package.json +2 -2
  67. package/src/config.ts +36 -0
  68. package/src/disposable.ts +1 -1
  69. package/src/error.ts +2 -1
  70. package/src/events.ts +8 -8
  71. package/src/fluidLoadable.ts +3 -3
  72. package/src/fluidRouter.ts +6 -6
  73. package/src/handles.ts +6 -6
  74. package/src/index.ts +1 -0
  75. package/src/logger.ts +13 -13
  76. 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
- * @internal
11
+ * @alpha
12
12
  */
13
13
  export const IFluidHandleContext: keyof IProvideFluidHandleContext = "IFluidHandleContext";
14
14
 
15
15
  /**
16
- * @internal
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
- * @internal
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
- * @internal
52
+ * @alpha
53
53
  */
54
54
  export const IFluidHandle: keyof IProvideFluidHandle = "IFluidHandle";
55
55
 
56
56
  /**
57
- * @internal
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
- * @internal
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
@@ -78,3 +78,4 @@ export type {
78
78
  } from "./logger";
79
79
  export { LogLevel } from "./logger";
80
80
  export { FluidObjectProviderKeys, FluidObject, FluidObjectKeys } from "./provider";
81
+ export { ConfigTypes, IConfigProviderBase } from "./config";
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
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
- * @internal
86
+ * @alpha
87
87
  */
88
88
  export type FluidObjectKeys<T> = keyof FluidObject<T>;