@fluidframework/runtime-definitions 2.0.0-rc.1.0.6 → 2.0.0-rc.2.0.1

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 (84) hide show
  1. package/.eslintrc.cjs +1 -1
  2. package/CHANGELOG.md +75 -0
  3. package/api-extractor-cjs.json +8 -0
  4. package/api-extractor-lint.json +1 -1
  5. package/api-extractor.json +1 -1
  6. package/api-report/runtime-definitions.api.md +98 -112
  7. package/dist/dataStoreContext.d.ts +110 -64
  8. package/dist/dataStoreContext.d.ts.map +1 -1
  9. package/dist/dataStoreContext.js +3 -0
  10. package/dist/dataStoreContext.js.map +1 -1
  11. package/dist/dataStoreFactory.d.ts +1 -1
  12. package/dist/dataStoreFactory.d.ts.map +1 -1
  13. package/dist/dataStoreFactory.js.map +1 -1
  14. package/dist/dataStoreRegistry.d.ts +1 -1
  15. package/dist/dataStoreRegistry.d.ts.map +1 -1
  16. package/dist/dataStoreRegistry.js.map +1 -1
  17. package/dist/{garbageCollection.d.ts → garbageCollectionDefinitions.d.ts} +1 -1
  18. package/dist/garbageCollectionDefinitions.d.ts.map +1 -0
  19. package/dist/{garbageCollection.js → garbageCollectionDefinitions.js} +1 -1
  20. package/dist/garbageCollectionDefinitions.js.map +1 -0
  21. package/dist/index.d.ts +12 -52
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +20 -27
  24. package/dist/index.js.map +1 -1
  25. package/dist/package.json +3 -0
  26. package/dist/protocol.d.ts +2 -1
  27. package/dist/protocol.d.ts.map +1 -1
  28. package/dist/protocol.js.map +1 -1
  29. package/dist/runtime-definitions-alpha.d.ts +184 -175
  30. package/dist/runtime-definitions-beta.d.ts +35 -57
  31. package/dist/runtime-definitions-public.d.ts +35 -57
  32. package/dist/runtime-definitions-untrimmed.d.ts +185 -175
  33. package/dist/summary.d.ts +15 -20
  34. package/dist/summary.d.ts.map +1 -1
  35. package/dist/summary.js.map +1 -1
  36. package/dist/tsdoc-metadata.json +1 -1
  37. package/lib/attribution.d.ts +71 -0
  38. package/lib/attribution.d.ts.map +1 -0
  39. package/lib/attribution.js +6 -0
  40. package/lib/attribution.js.map +1 -0
  41. package/lib/dataStoreContext.d.ts +469 -0
  42. package/lib/dataStoreContext.d.ts.map +1 -0
  43. package/lib/dataStoreContext.js +67 -0
  44. package/lib/dataStoreContext.js.map +1 -0
  45. package/lib/dataStoreFactory.d.ts +33 -0
  46. package/lib/dataStoreFactory.d.ts.map +1 -0
  47. package/lib/dataStoreFactory.js +9 -0
  48. package/lib/dataStoreFactory.js.map +1 -0
  49. package/lib/dataStoreRegistry.d.ts +41 -0
  50. package/lib/dataStoreRegistry.d.ts.map +1 -0
  51. package/lib/dataStoreRegistry.js +9 -0
  52. package/lib/dataStoreRegistry.js.map +1 -0
  53. package/lib/garbageCollectionDefinitions.d.ts +62 -0
  54. package/lib/garbageCollectionDefinitions.d.ts.map +1 -0
  55. package/lib/garbageCollectionDefinitions.js +35 -0
  56. package/lib/garbageCollectionDefinitions.js.map +1 -0
  57. package/lib/index.d.ts +17 -0
  58. package/lib/index.d.ts.map +1 -0
  59. package/lib/index.js +10 -0
  60. package/lib/index.js.map +1 -0
  61. package/lib/protocol.d.ts +77 -0
  62. package/lib/protocol.d.ts.map +1 -0
  63. package/lib/protocol.js +6 -0
  64. package/lib/protocol.js.map +1 -0
  65. package/lib/runtime-definitions-alpha.d.ts +1025 -0
  66. package/lib/runtime-definitions-beta.d.ts +244 -0
  67. package/lib/runtime-definitions-public.d.ts +244 -0
  68. package/lib/runtime-definitions-untrimmed.d.ts +1106 -0
  69. package/lib/summary.d.ts +322 -0
  70. package/lib/summary.d.ts.map +1 -0
  71. package/lib/summary.js +26 -0
  72. package/lib/summary.js.map +1 -0
  73. package/package.json +111 -34
  74. package/src/dataStoreContext.ts +133 -80
  75. package/src/dataStoreFactory.ts +1 -1
  76. package/src/dataStoreRegistry.ts +1 -1
  77. package/src/index.ts +25 -70
  78. package/src/protocol.ts +2 -1
  79. package/src/summary.ts +18 -20
  80. package/tsconfig.cjs.json +7 -0
  81. package/tsconfig.json +2 -5
  82. package/dist/garbageCollection.d.ts.map +0 -1
  83. package/dist/garbageCollection.js.map +0 -1
  84. /package/src/{garbageCollection.ts → garbageCollectionDefinitions.ts} +0 -0
@@ -1,39 +1,28 @@
1
- import { AttachState } from '@fluidframework/container-definitions';
2
- import { FluidObject } from '@fluidframework/core-interfaces';
3
- import { IAudience } from '@fluidframework/container-definitions';
4
- import { IClientDetails } from '@fluidframework/protocol-definitions';
5
- import { IdCompressor } from '@fluidframework/id-compressor';
6
- import { IdCreationRange } from '@fluidframework/id-compressor';
7
- import { IDeltaManager } from '@fluidframework/container-definitions';
8
- import { IDisposable } from '@fluidframework/core-interfaces';
9
- import { IDocumentMessage } from '@fluidframework/protocol-definitions';
10
- import { IDocumentStorageService } from '@fluidframework/driver-definitions';
11
- import { IEvent } from '@fluidframework/core-interfaces';
12
- import { IEventProvider } from '@fluidframework/core-interfaces';
13
- import { IFluidHandle } from '@fluidframework/core-interfaces';
14
- import { IIdCompressor } from '@fluidframework/id-compressor';
15
- import { IIdCompressorCore } from '@fluidframework/id-compressor';
16
- import { ILoaderOptions } from '@fluidframework/container-definitions';
17
- import { IProvideFluidHandleContext } from '@fluidframework/core-interfaces';
18
- import { IQuorumClients } from '@fluidframework/protocol-definitions';
19
- import { IRequest } from '@fluidframework/core-interfaces';
20
- import { IResponse } from '@fluidframework/core-interfaces';
21
- import { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
22
- import { ISignalMessage } from '@fluidframework/protocol-definitions';
23
- import { ISnapshotTree } from '@fluidframework/protocol-definitions';
24
- import { ISummaryTree } from '@fluidframework/protocol-definitions';
25
- import { ITelemetryBaseLogger } from '@fluidframework/core-interfaces';
26
- import { ITree } from '@fluidframework/protocol-definitions';
1
+ import type { AttachState } from '@fluidframework/container-definitions';
2
+ import type { FluidObject } from '@fluidframework/core-interfaces';
3
+ import type { IAudience } from '@fluidframework/container-definitions';
4
+ import type { IClientDetails } from '@fluidframework/protocol-definitions';
5
+ import type { IDeltaManager } from '@fluidframework/container-definitions';
6
+ import type { IDisposable } from '@fluidframework/core-interfaces';
7
+ import type { IDocumentMessage } from '@fluidframework/protocol-definitions';
8
+ import type { IDocumentStorageService } from '@fluidframework/driver-definitions';
9
+ import type { IEvent } from '@fluidframework/core-interfaces';
10
+ import type { IEventProvider } from '@fluidframework/core-interfaces';
11
+ import type { IFluidHandle } from '@fluidframework/core-interfaces';
12
+ import type { IIdCompressor } from '@fluidframework/id-compressor';
13
+ import type { IProvideFluidHandleContext } from '@fluidframework/core-interfaces';
14
+ import type { IQuorumClients } from '@fluidframework/protocol-definitions';
15
+ import type { IRequest } from '@fluidframework/core-interfaces';
16
+ import type { IResponse } from '@fluidframework/core-interfaces';
17
+ import type { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
18
+ import type { ISignalMessage } from '@fluidframework/protocol-definitions';
19
+ import type { ISnapshotTree } from '@fluidframework/protocol-definitions';
20
+ import type { ISummaryTree } from '@fluidframework/protocol-definitions';
21
+ import type { ITelemetryBaseLogger } from '@fluidframework/core-interfaces';
22
+ import type { ITree } from '@fluidframework/protocol-definitions';
27
23
  import type { IUser } from '@fluidframework/protocol-definitions';
28
- import { OpSpaceCompressedId } from '@fluidframework/id-compressor';
29
- import { SerializedIdCompressor } from '@fluidframework/id-compressor';
30
- import { SerializedIdCompressorWithNoSession } from '@fluidframework/id-compressor';
31
- import { SerializedIdCompressorWithOngoingSession } from '@fluidframework/id-compressor';
32
- import { SessionId } from '@fluidframework/id-compressor';
33
- import { SessionSpaceCompressedId } from '@fluidframework/id-compressor';
34
- import { StableId } from '@fluidframework/id-compressor';
35
- import { SummaryTree } from '@fluidframework/protocol-definitions';
36
- import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
24
+ import type { SummaryTree } from '@fluidframework/protocol-definitions';
25
+ import type { TelemetryBaseEventPropertyType } from '@fluidframework/core-interfaces';
37
26
 
38
27
  /* Excluded from this release type: AliasResult */
39
28
 
@@ -77,10 +66,6 @@ import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
77
66
 
78
67
  /* Excluded from this release type: IDataStore */
79
68
 
80
- /* Excluded from this release type: IdCompressor */
81
-
82
- /* Excluded from this release type: IdCreationRange */
83
-
84
69
  /* Excluded from this release type: IDocumentStorageService */
85
70
 
86
71
  /* Excluded from this release type: IEnvelope */
@@ -124,6 +109,8 @@ export declare interface IExperimentalIncrementalSummaryContext {
124
109
 
125
110
  /* Excluded from this release type: IFluidDataStoreRegistry */
126
111
 
112
+ /* Excluded from this release type: IFluidParentContext */
113
+
127
114
  /**
128
115
  * Garbage collection data returned by nodes in a Container.
129
116
  * Used for running GC in the Container.
@@ -139,9 +126,6 @@ export declare interface IGarbageCollectionData {
139
126
  }
140
127
 
141
128
  /* Excluded from this release type: IGarbageCollectionDetailsBase */
142
- export { IIdCompressor }
143
-
144
- /* Excluded from this release type: IIdCompressorCore */
145
129
 
146
130
  /**
147
131
  * Represents ISignalMessage with its type.
@@ -215,24 +199,30 @@ export declare interface ITelemetryContext {
215
199
  * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
216
200
  * @param value - value to attribute to this summary telemetry data
217
201
  */
218
- set(prefix: string, property: string, value: TelemetryEventPropertyType): void;
202
+ set(prefix: string, property: string, value: TelemetryBaseEventPropertyType): void;
219
203
  /**
220
204
  * Sets multiple values for telemetry data being tracked.
221
205
  * @param prefix - unique prefix to tag this data with (ex: "fluid:summarize:")
222
206
  * @param property - property name of the telemetry data being tracked (ex: "Options")
223
207
  * @param values - A set of values to attribute to this summary telemetry data.
224
208
  */
225
- setMultiple(prefix: string, property: string, values: Record<string, TelemetryEventPropertyType>): void;
209
+ setMultiple(prefix: string, property: string, values: Record<string, TelemetryBaseEventPropertyType>): void;
226
210
  /**
227
211
  * Get the telemetry data being tracked
212
+ *
213
+ * @deprecated This interface should only be used for instrumenting, not for attempting to read already-set telemetry data.
214
+ *
228
215
  * @param prefix - unique prefix for this data (ex: "fluid:map:")
229
216
  * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
230
217
  * @returns undefined if item not found
231
218
  */
232
- get(prefix: string, property: string): TelemetryEventPropertyType;
219
+ get(prefix: string, property: string): TelemetryBaseEventPropertyType;
233
220
  /**
234
221
  * Returns a serialized version of all the telemetry data.
235
222
  * Should be used when logging in telemetry events.
223
+ *
224
+ * @deprecated This interface should only be used for instrumenting. A concrete implementation will likely have a serialize function
225
+ * but this functionality should not be used by other code being given an ITelemetryContext.
236
226
  */
237
227
  serialize(): string;
238
228
  }
@@ -244,18 +234,6 @@ export declare interface ITelemetryContext {
244
234
  /* Excluded from this release type: NamedFluidDataStoreRegistryEntry */
245
235
 
246
236
  /* Excluded from this release type: OpAttributionKey */
247
- export { OpSpaceCompressedId }
248
-
249
- /* Excluded from this release type: SerializedIdCompressor */
250
-
251
- /* Excluded from this release type: SerializedIdCompressorWithNoSession */
252
-
253
- /* Excluded from this release type: SerializedIdCompressorWithOngoingSession */
254
- export { SessionId }
255
-
256
- export { SessionSpaceCompressedId }
257
-
258
- export { StableId }
259
237
 
260
238
  /* Excluded from this release type: SummarizeInternalFn */
261
239
 
@@ -1,39 +1,28 @@
1
- import { AttachState } from '@fluidframework/container-definitions';
2
- import { FluidObject } from '@fluidframework/core-interfaces';
3
- import { IAudience } from '@fluidframework/container-definitions';
4
- import { IClientDetails } from '@fluidframework/protocol-definitions';
5
- import { IdCompressor } from '@fluidframework/id-compressor';
6
- import { IdCreationRange } from '@fluidframework/id-compressor';
7
- import { IDeltaManager } from '@fluidframework/container-definitions';
8
- import { IDisposable } from '@fluidframework/core-interfaces';
9
- import { IDocumentMessage } from '@fluidframework/protocol-definitions';
10
- import { IDocumentStorageService } from '@fluidframework/driver-definitions';
11
- import { IEvent } from '@fluidframework/core-interfaces';
12
- import { IEventProvider } from '@fluidframework/core-interfaces';
13
- import { IFluidHandle } from '@fluidframework/core-interfaces';
14
- import { IIdCompressor } from '@fluidframework/id-compressor';
15
- import { IIdCompressorCore } from '@fluidframework/id-compressor';
16
- import { ILoaderOptions } from '@fluidframework/container-definitions';
17
- import { IProvideFluidHandleContext } from '@fluidframework/core-interfaces';
18
- import { IQuorumClients } from '@fluidframework/protocol-definitions';
19
- import { IRequest } from '@fluidframework/core-interfaces';
20
- import { IResponse } from '@fluidframework/core-interfaces';
21
- import { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
22
- import { ISignalMessage } from '@fluidframework/protocol-definitions';
23
- import { ISnapshotTree } from '@fluidframework/protocol-definitions';
24
- import { ISummaryTree } from '@fluidframework/protocol-definitions';
25
- import { ITelemetryBaseLogger } from '@fluidframework/core-interfaces';
26
- import { ITree } from '@fluidframework/protocol-definitions';
1
+ import type { AttachState } from '@fluidframework/container-definitions';
2
+ import type { FluidObject } from '@fluidframework/core-interfaces';
3
+ import type { IAudience } from '@fluidframework/container-definitions';
4
+ import type { IClientDetails } from '@fluidframework/protocol-definitions';
5
+ import type { IDeltaManager } from '@fluidframework/container-definitions';
6
+ import type { IDisposable } from '@fluidframework/core-interfaces';
7
+ import type { IDocumentMessage } from '@fluidframework/protocol-definitions';
8
+ import type { IDocumentStorageService } from '@fluidframework/driver-definitions';
9
+ import type { IEvent } from '@fluidframework/core-interfaces';
10
+ import type { IEventProvider } from '@fluidframework/core-interfaces';
11
+ import type { IFluidHandle } from '@fluidframework/core-interfaces';
12
+ import type { IIdCompressor } from '@fluidframework/id-compressor';
13
+ import type { IProvideFluidHandleContext } from '@fluidframework/core-interfaces';
14
+ import type { IQuorumClients } from '@fluidframework/protocol-definitions';
15
+ import type { IRequest } from '@fluidframework/core-interfaces';
16
+ import type { IResponse } from '@fluidframework/core-interfaces';
17
+ import type { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
18
+ import type { ISignalMessage } from '@fluidframework/protocol-definitions';
19
+ import type { ISnapshotTree } from '@fluidframework/protocol-definitions';
20
+ import type { ISummaryTree } from '@fluidframework/protocol-definitions';
21
+ import type { ITelemetryBaseLogger } from '@fluidframework/core-interfaces';
22
+ import type { ITree } from '@fluidframework/protocol-definitions';
27
23
  import type { IUser } from '@fluidframework/protocol-definitions';
28
- import { OpSpaceCompressedId } from '@fluidframework/id-compressor';
29
- import { SerializedIdCompressor } from '@fluidframework/id-compressor';
30
- import { SerializedIdCompressorWithNoSession } from '@fluidframework/id-compressor';
31
- import { SerializedIdCompressorWithOngoingSession } from '@fluidframework/id-compressor';
32
- import { SessionId } from '@fluidframework/id-compressor';
33
- import { SessionSpaceCompressedId } from '@fluidframework/id-compressor';
34
- import { StableId } from '@fluidframework/id-compressor';
35
- import { SummaryTree } from '@fluidframework/protocol-definitions';
36
- import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
24
+ import type { SummaryTree } from '@fluidframework/protocol-definitions';
25
+ import type { TelemetryBaseEventPropertyType } from '@fluidframework/core-interfaces';
37
26
 
38
27
  /* Excluded from this release type: AliasResult */
39
28
 
@@ -77,10 +66,6 @@ import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
77
66
 
78
67
  /* Excluded from this release type: IDataStore */
79
68
 
80
- /* Excluded from this release type: IdCompressor */
81
-
82
- /* Excluded from this release type: IdCreationRange */
83
-
84
69
  /* Excluded from this release type: IDocumentStorageService */
85
70
 
86
71
  /* Excluded from this release type: IEnvelope */
@@ -124,6 +109,8 @@ export declare interface IExperimentalIncrementalSummaryContext {
124
109
 
125
110
  /* Excluded from this release type: IFluidDataStoreRegistry */
126
111
 
112
+ /* Excluded from this release type: IFluidParentContext */
113
+
127
114
  /**
128
115
  * Garbage collection data returned by nodes in a Container.
129
116
  * Used for running GC in the Container.
@@ -139,9 +126,6 @@ export declare interface IGarbageCollectionData {
139
126
  }
140
127
 
141
128
  /* Excluded from this release type: IGarbageCollectionDetailsBase */
142
- export { IIdCompressor }
143
-
144
- /* Excluded from this release type: IIdCompressorCore */
145
129
 
146
130
  /**
147
131
  * Represents ISignalMessage with its type.
@@ -215,24 +199,30 @@ export declare interface ITelemetryContext {
215
199
  * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
216
200
  * @param value - value to attribute to this summary telemetry data
217
201
  */
218
- set(prefix: string, property: string, value: TelemetryEventPropertyType): void;
202
+ set(prefix: string, property: string, value: TelemetryBaseEventPropertyType): void;
219
203
  /**
220
204
  * Sets multiple values for telemetry data being tracked.
221
205
  * @param prefix - unique prefix to tag this data with (ex: "fluid:summarize:")
222
206
  * @param property - property name of the telemetry data being tracked (ex: "Options")
223
207
  * @param values - A set of values to attribute to this summary telemetry data.
224
208
  */
225
- setMultiple(prefix: string, property: string, values: Record<string, TelemetryEventPropertyType>): void;
209
+ setMultiple(prefix: string, property: string, values: Record<string, TelemetryBaseEventPropertyType>): void;
226
210
  /**
227
211
  * Get the telemetry data being tracked
212
+ *
213
+ * @deprecated This interface should only be used for instrumenting, not for attempting to read already-set telemetry data.
214
+ *
228
215
  * @param prefix - unique prefix for this data (ex: "fluid:map:")
229
216
  * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
230
217
  * @returns undefined if item not found
231
218
  */
232
- get(prefix: string, property: string): TelemetryEventPropertyType;
219
+ get(prefix: string, property: string): TelemetryBaseEventPropertyType;
233
220
  /**
234
221
  * Returns a serialized version of all the telemetry data.
235
222
  * Should be used when logging in telemetry events.
223
+ *
224
+ * @deprecated This interface should only be used for instrumenting. A concrete implementation will likely have a serialize function
225
+ * but this functionality should not be used by other code being given an ITelemetryContext.
236
226
  */
237
227
  serialize(): string;
238
228
  }
@@ -244,18 +234,6 @@ export declare interface ITelemetryContext {
244
234
  /* Excluded from this release type: NamedFluidDataStoreRegistryEntry */
245
235
 
246
236
  /* Excluded from this release type: OpAttributionKey */
247
- export { OpSpaceCompressedId }
248
-
249
- /* Excluded from this release type: SerializedIdCompressor */
250
-
251
- /* Excluded from this release type: SerializedIdCompressorWithNoSession */
252
-
253
- /* Excluded from this release type: SerializedIdCompressorWithOngoingSession */
254
- export { SessionId }
255
-
256
- export { SessionSpaceCompressedId }
257
-
258
- export { StableId }
259
237
 
260
238
  /* Excluded from this release type: SummarizeInternalFn */
261
239