@fluidframework/runtime-definitions 2.0.0-dev-rc.1.0.0.228517 → 2.0.0-dev-rc.2.0.0.245554

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 +103 -116
  7. package/dist/dataStoreContext.d.ts +128 -69
  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} +8 -2
  18. package/dist/garbageCollectionDefinitions.d.ts.map +1 -0
  19. package/dist/{garbageCollection.js → garbageCollectionDefinitions.js} +9 -3
  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 -26
  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 +188 -165
  30. package/dist/runtime-definitions-beta.d.ts +37 -59
  31. package/dist/runtime-definitions-public.d.ts +37 -59
  32. package/dist/runtime-definitions-untrimmed.d.ts +195 -166
  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 +464 -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 +1019 -0
  66. package/lib/runtime-definitions-beta.d.ts +242 -0
  67. package/lib/runtime-definitions-public.d.ts +242 -0
  68. package/lib/runtime-definitions-untrimmed.d.ts +1100 -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 +115 -33
  74. package/src/dataStoreContext.ts +151 -85
  75. package/src/dataStoreFactory.ts +1 -1
  76. package/src/dataStoreRegistry.ts +1 -1
  77. package/src/{garbageCollection.ts → garbageCollectionDefinitions.ts} +7 -1
  78. package/src/index.ts +26 -71
  79. package/src/protocol.ts +2 -1
  80. package/src/summary.ts +18 -20
  81. package/tsconfig.cjs.json +7 -0
  82. package/tsconfig.json +2 -5
  83. package/dist/garbageCollection.d.ts.map +0 -1
  84. package/dist/garbageCollection.js.map +0 -1
@@ -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
 
@@ -61,6 +50,8 @@ import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
61
50
 
62
51
  /* Excluded from this release type: gcBlobPrefix */
63
52
 
53
+ /* Excluded from this release type: gcDataBlobKey */
54
+
64
55
  /* Excluded from this release type: gcDeletedBlobKey */
65
56
 
66
57
  /* Excluded from this release type: gcTombstoneBlobKey */
@@ -75,10 +66,6 @@ import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
75
66
 
76
67
  /* Excluded from this release type: IDataStore */
77
68
 
78
- /* Excluded from this release type: IdCompressor */
79
-
80
- /* Excluded from this release type: IdCreationRange */
81
-
82
69
  /* Excluded from this release type: IDocumentStorageService */
83
70
 
84
71
  /* Excluded from this release type: IEnvelope */
@@ -116,12 +103,12 @@ export declare interface IExperimentalIncrementalSummaryContext {
116
103
 
117
104
  /* Excluded from this release type: IFluidDataStoreContextDetached */
118
105
 
119
- /* Excluded from this release type: IFluidDataStoreContextEvents */
120
-
121
106
  /* Excluded from this release type: IFluidDataStoreFactory */
122
107
 
123
108
  /* Excluded from this release type: IFluidDataStoreRegistry */
124
109
 
110
+ /* Excluded from this release type: IFluidParentContext */
111
+
125
112
  /**
126
113
  * Garbage collection data returned by nodes in a Container.
127
114
  * Used for running GC in the Container.
@@ -137,9 +124,6 @@ export declare interface IGarbageCollectionData {
137
124
  }
138
125
 
139
126
  /* Excluded from this release type: IGarbageCollectionDetailsBase */
140
- export { IIdCompressor }
141
-
142
- /* Excluded from this release type: IIdCompressorCore */
143
127
 
144
128
  /**
145
129
  * Represents ISignalMessage with its type.
@@ -213,24 +197,30 @@ export declare interface ITelemetryContext {
213
197
  * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
214
198
  * @param value - value to attribute to this summary telemetry data
215
199
  */
216
- set(prefix: string, property: string, value: TelemetryEventPropertyType): void;
200
+ set(prefix: string, property: string, value: TelemetryBaseEventPropertyType): void;
217
201
  /**
218
202
  * Sets multiple values for telemetry data being tracked.
219
203
  * @param prefix - unique prefix to tag this data with (ex: "fluid:summarize:")
220
204
  * @param property - property name of the telemetry data being tracked (ex: "Options")
221
205
  * @param values - A set of values to attribute to this summary telemetry data.
222
206
  */
223
- setMultiple(prefix: string, property: string, values: Record<string, TelemetryEventPropertyType>): void;
207
+ setMultiple(prefix: string, property: string, values: Record<string, TelemetryBaseEventPropertyType>): void;
224
208
  /**
225
209
  * Get the telemetry data being tracked
210
+ *
211
+ * @deprecated This interface should only be used for instrumenting, not for attempting to read already-set telemetry data.
212
+ *
226
213
  * @param prefix - unique prefix for this data (ex: "fluid:map:")
227
214
  * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
228
215
  * @returns undefined if item not found
229
216
  */
230
- get(prefix: string, property: string): TelemetryEventPropertyType;
217
+ get(prefix: string, property: string): TelemetryBaseEventPropertyType;
231
218
  /**
232
219
  * Returns a serialized version of all the telemetry data.
233
220
  * Should be used when logging in telemetry events.
221
+ *
222
+ * @deprecated This interface should only be used for instrumenting. A concrete implementation will likely have a serialize function
223
+ * but this functionality should not be used by other code being given an ITelemetryContext.
234
224
  */
235
225
  serialize(): string;
236
226
  }
@@ -242,18 +232,6 @@ export declare interface ITelemetryContext {
242
232
  /* Excluded from this release type: NamedFluidDataStoreRegistryEntry */
243
233
 
244
234
  /* Excluded from this release type: OpAttributionKey */
245
- export { OpSpaceCompressedId }
246
-
247
- /* Excluded from this release type: SerializedIdCompressor */
248
-
249
- /* Excluded from this release type: SerializedIdCompressorWithNoSession */
250
-
251
- /* Excluded from this release type: SerializedIdCompressorWithOngoingSession */
252
- export { SessionId }
253
-
254
- export { SessionSpaceCompressedId }
255
-
256
- export { StableId }
257
235
 
258
236
  /* Excluded from this release type: SummarizeInternalFn */
259
237
 
@@ -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
 
@@ -61,6 +50,8 @@ import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
61
50
 
62
51
  /* Excluded from this release type: gcBlobPrefix */
63
52
 
53
+ /* Excluded from this release type: gcDataBlobKey */
54
+
64
55
  /* Excluded from this release type: gcDeletedBlobKey */
65
56
 
66
57
  /* Excluded from this release type: gcTombstoneBlobKey */
@@ -75,10 +66,6 @@ import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
75
66
 
76
67
  /* Excluded from this release type: IDataStore */
77
68
 
78
- /* Excluded from this release type: IdCompressor */
79
-
80
- /* Excluded from this release type: IdCreationRange */
81
-
82
69
  /* Excluded from this release type: IDocumentStorageService */
83
70
 
84
71
  /* Excluded from this release type: IEnvelope */
@@ -116,12 +103,12 @@ export declare interface IExperimentalIncrementalSummaryContext {
116
103
 
117
104
  /* Excluded from this release type: IFluidDataStoreContextDetached */
118
105
 
119
- /* Excluded from this release type: IFluidDataStoreContextEvents */
120
-
121
106
  /* Excluded from this release type: IFluidDataStoreFactory */
122
107
 
123
108
  /* Excluded from this release type: IFluidDataStoreRegistry */
124
109
 
110
+ /* Excluded from this release type: IFluidParentContext */
111
+
125
112
  /**
126
113
  * Garbage collection data returned by nodes in a Container.
127
114
  * Used for running GC in the Container.
@@ -137,9 +124,6 @@ export declare interface IGarbageCollectionData {
137
124
  }
138
125
 
139
126
  /* Excluded from this release type: IGarbageCollectionDetailsBase */
140
- export { IIdCompressor }
141
-
142
- /* Excluded from this release type: IIdCompressorCore */
143
127
 
144
128
  /**
145
129
  * Represents ISignalMessage with its type.
@@ -213,24 +197,30 @@ export declare interface ITelemetryContext {
213
197
  * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
214
198
  * @param value - value to attribute to this summary telemetry data
215
199
  */
216
- set(prefix: string, property: string, value: TelemetryEventPropertyType): void;
200
+ set(prefix: string, property: string, value: TelemetryBaseEventPropertyType): void;
217
201
  /**
218
202
  * Sets multiple values for telemetry data being tracked.
219
203
  * @param prefix - unique prefix to tag this data with (ex: "fluid:summarize:")
220
204
  * @param property - property name of the telemetry data being tracked (ex: "Options")
221
205
  * @param values - A set of values to attribute to this summary telemetry data.
222
206
  */
223
- setMultiple(prefix: string, property: string, values: Record<string, TelemetryEventPropertyType>): void;
207
+ setMultiple(prefix: string, property: string, values: Record<string, TelemetryBaseEventPropertyType>): void;
224
208
  /**
225
209
  * Get the telemetry data being tracked
210
+ *
211
+ * @deprecated This interface should only be used for instrumenting, not for attempting to read already-set telemetry data.
212
+ *
226
213
  * @param prefix - unique prefix for this data (ex: "fluid:map:")
227
214
  * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
228
215
  * @returns undefined if item not found
229
216
  */
230
- get(prefix: string, property: string): TelemetryEventPropertyType;
217
+ get(prefix: string, property: string): TelemetryBaseEventPropertyType;
231
218
  /**
232
219
  * Returns a serialized version of all the telemetry data.
233
220
  * Should be used when logging in telemetry events.
221
+ *
222
+ * @deprecated This interface should only be used for instrumenting. A concrete implementation will likely have a serialize function
223
+ * but this functionality should not be used by other code being given an ITelemetryContext.
234
224
  */
235
225
  serialize(): string;
236
226
  }
@@ -242,18 +232,6 @@ export declare interface ITelemetryContext {
242
232
  /* Excluded from this release type: NamedFluidDataStoreRegistryEntry */
243
233
 
244
234
  /* Excluded from this release type: OpAttributionKey */
245
- export { OpSpaceCompressedId }
246
-
247
- /* Excluded from this release type: SerializedIdCompressor */
248
-
249
- /* Excluded from this release type: SerializedIdCompressorWithNoSession */
250
-
251
- /* Excluded from this release type: SerializedIdCompressorWithOngoingSession */
252
- export { SessionId }
253
-
254
- export { SessionSpaceCompressedId }
255
-
256
- export { StableId }
257
235
 
258
236
  /* Excluded from this release type: SummarizeInternalFn */
259
237