@fluidframework/runtime-definitions 2.0.0-rc.2.0.2 → 2.0.0-rc.3.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 (45) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/api-report/runtime-definitions.api.md +8 -12
  3. package/dist/dataStoreContext.d.ts +16 -21
  4. package/dist/dataStoreContext.d.ts.map +1 -1
  5. package/dist/dataStoreContext.js.map +1 -1
  6. package/dist/dataStoreFactory.d.ts +1 -1
  7. package/dist/dataStoreFactory.js.map +1 -1
  8. package/dist/index.d.ts +1 -1
  9. package/dist/index.d.ts.map +1 -1
  10. package/dist/index.js.map +1 -1
  11. package/dist/legacy.d.ts +56 -0
  12. package/dist/public.d.ts +19 -0
  13. package/dist/summary.d.ts +1 -1
  14. package/dist/summary.d.ts.map +1 -1
  15. package/dist/summary.js.map +1 -1
  16. package/internal.d.ts +11 -0
  17. package/legacy.d.ts +11 -0
  18. package/lib/dataStoreContext.d.ts +16 -21
  19. package/lib/dataStoreContext.d.ts.map +1 -1
  20. package/lib/dataStoreContext.js.map +1 -1
  21. package/lib/dataStoreFactory.d.ts +1 -1
  22. package/lib/dataStoreFactory.js.map +1 -1
  23. package/lib/index.d.ts +1 -1
  24. package/lib/index.d.ts.map +1 -1
  25. package/lib/index.js.map +1 -1
  26. package/lib/legacy.d.ts +56 -0
  27. package/lib/public.d.ts +19 -0
  28. package/lib/summary.d.ts +1 -1
  29. package/lib/summary.d.ts.map +1 -1
  30. package/lib/summary.js.map +1 -1
  31. package/package.json +33 -49
  32. package/src/dataStoreContext.ts +22 -28
  33. package/src/dataStoreFactory.ts +1 -1
  34. package/src/index.ts +0 -1
  35. package/src/summary.ts +3 -2
  36. package/api-extractor-cjs.json +0 -8
  37. package/dist/runtime-definitions-alpha.d.ts +0 -1025
  38. package/dist/runtime-definitions-beta.d.ts +0 -244
  39. package/dist/runtime-definitions-public.d.ts +0 -244
  40. package/dist/runtime-definitions-untrimmed.d.ts +0 -1106
  41. package/lib/runtime-definitions-alpha.d.ts +0 -1025
  42. package/lib/runtime-definitions-beta.d.ts +0 -244
  43. package/lib/runtime-definitions-public.d.ts +0 -244
  44. package/lib/runtime-definitions-untrimmed.d.ts +0 -1106
  45. /package/{dist → lib}/tsdoc-metadata.json +0 -0
@@ -1,244 +0,0 @@
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';
23
- import type { IUser } from '@fluidframework/protocol-definitions';
24
- import type { SummaryTree } from '@fluidframework/protocol-definitions';
25
- import type { TelemetryBaseEventPropertyType } from '@fluidframework/core-interfaces';
26
-
27
- /* Excluded from this release type: AliasResult */
28
-
29
- /* Excluded from this release type: AttributionInfo */
30
-
31
- /* Excluded from this release type: AttributionKey */
32
-
33
- /* Excluded from this release type: blobCountPropertyName */
34
-
35
- /* Excluded from this release type: channelsTreeName */
36
-
37
- /* Excluded from this release type: CreateChildSummarizerNodeFn */
38
-
39
- /* Excluded from this release type: CreateChildSummarizerNodeParam */
40
-
41
- /* Excluded from this release type: CreateSummarizerNodeSource */
42
-
43
- /* Excluded from this release type: DetachedAttributionKey */
44
-
45
- /* Excluded from this release type: FluidDataStoreRegistryEntry */
46
-
47
- /* Excluded from this release type: FlushMode */
48
-
49
- /* Excluded from this release type: FlushModeExperimental */
50
-
51
- /* Excluded from this release type: gcBlobPrefix */
52
-
53
- /* Excluded from this release type: gcDataBlobKey */
54
-
55
- /* Excluded from this release type: gcDeletedBlobKey */
56
-
57
- /* Excluded from this release type: gcTombstoneBlobKey */
58
-
59
- /* Excluded from this release type: gcTreeKey */
60
-
61
- /* Excluded from this release type: IAttachMessage */
62
-
63
- /* Excluded from this release type: IContainerRuntimeBase */
64
-
65
- /* Excluded from this release type: IContainerRuntimeBaseEvents */
66
-
67
- /* Excluded from this release type: IDataStore */
68
-
69
- /* Excluded from this release type: IDocumentStorageService */
70
-
71
- /* Excluded from this release type: IEnvelope */
72
-
73
- /**
74
- * @experimental - Can be deleted/changed at any time
75
- * Contains the necessary information to allow DDSes to do incremental summaries
76
- * @public
77
- */
78
- export declare interface IExperimentalIncrementalSummaryContext {
79
- /**
80
- * The sequence number of the summary generated that will be sent to the server.
81
- */
82
- summarySequenceNumber: number;
83
- /**
84
- * The sequence number of the most recent summary that was acknowledged by the server.
85
- */
86
- latestSummarySequenceNumber: number;
87
- /**
88
- * The path to the runtime/datastore/dds that is used to generate summary handles
89
- * Note: Summary handles are nodes of the summary tree that point to previous parts of the last successful summary
90
- * instead of being a blob or tree node
91
- *
92
- * This path contains the id of the data store and dds which should not be leaked to layers below them. Ideally,
93
- * a layer should not know its own id. This is important for channel unification work and there has been a lot of
94
- * work to remove these kinds of leakages. Some still exist, which have to be fixed but we should not be adding
95
- * more dependencies.
96
- */
97
- summaryPath: string;
98
- }
99
-
100
- /* Excluded from this release type: IFluidDataStoreChannel */
101
-
102
- /* Excluded from this release type: IFluidDataStoreContext */
103
-
104
- /* Excluded from this release type: IFluidDataStoreContextDetached */
105
-
106
- /* Excluded from this release type: IFluidDataStoreContextEvents */
107
-
108
- /* Excluded from this release type: IFluidDataStoreFactory */
109
-
110
- /* Excluded from this release type: IFluidDataStoreRegistry */
111
-
112
- /* Excluded from this release type: IFluidParentContext */
113
-
114
- /**
115
- * Garbage collection data returned by nodes in a Container.
116
- * Used for running GC in the Container.
117
- * @public
118
- */
119
- export declare interface IGarbageCollectionData {
120
- /**
121
- * The GC nodes of a Fluid object in the Container. Each node has an id and a set of routes to other GC nodes.
122
- */
123
- gcNodes: {
124
- [id: string]: string[];
125
- };
126
- }
127
-
128
- /* Excluded from this release type: IGarbageCollectionDetailsBase */
129
-
130
- /**
131
- * Represents ISignalMessage with its type.
132
- * @public
133
- */
134
- export declare interface IInboundSignalMessage extends ISignalMessage {
135
- type: string;
136
- }
137
-
138
- /* Excluded from this release type: InboundAttachMessage */
139
-
140
- /* Excluded from this release type: IProvideFluidDataStoreFactory */
141
-
142
- /* Excluded from this release type: IProvideFluidDataStoreRegistry */
143
-
144
- /* Excluded from this release type: ISignalEnvelope */
145
-
146
- /* Excluded from this release type: ISummarizeInternalResult */
147
-
148
- /* Excluded from this release type: ISummarizeResult */
149
-
150
- /* Excluded from this release type: ISummarizerNode */
151
-
152
- /* Excluded from this release type: ISummarizerNodeConfig */
153
-
154
- /* Excluded from this release type: ISummarizerNodeConfigWithGC */
155
-
156
- /* Excluded from this release type: ISummarizerNodeWithGC */
157
-
158
- /**
159
- * Contains the aggregation data from a Tree/Subtree.
160
- * @public
161
- */
162
- export declare interface ISummaryStats {
163
- treeNodeCount: number;
164
- blobNodeCount: number;
165
- handleNodeCount: number;
166
- totalBlobSize: number;
167
- unreferencedBlobSize: number;
168
- }
169
-
170
- /**
171
- * Represents the summary tree for a node along with the statistics for that tree.
172
- * For example, for a given data store, it contains the data for data store along with a subtree for
173
- * each of its DDS.
174
- * Any component that implements IChannelContext, IFluidDataStoreChannel or extends SharedObject
175
- * will be taking part of the summarization process.
176
- * @public
177
- */
178
- export declare interface ISummaryTreeWithStats {
179
- /**
180
- * Represents an aggregation of node counts and blob sizes associated to the current summary information
181
- */
182
- stats: ISummaryStats;
183
- /**
184
- * A recursive data structure that will be converted to a snapshot tree and uploaded
185
- * to the backend.
186
- */
187
- summary: ISummaryTree;
188
- }
189
-
190
- /**
191
- * Contains telemetry data relevant to summarization workflows.
192
- * This object is expected to be modified directly by various summarize methods.
193
- * @public
194
- */
195
- export declare interface ITelemetryContext {
196
- /**
197
- * Sets value for telemetry data being tracked.
198
- * @param prefix - unique prefix to tag this data with (ex: "fluid:map:")
199
- * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
200
- * @param value - value to attribute to this summary telemetry data
201
- */
202
- set(prefix: string, property: string, value: TelemetryBaseEventPropertyType): void;
203
- /**
204
- * Sets multiple values for telemetry data being tracked.
205
- * @param prefix - unique prefix to tag this data with (ex: "fluid:summarize:")
206
- * @param property - property name of the telemetry data being tracked (ex: "Options")
207
- * @param values - A set of values to attribute to this summary telemetry data.
208
- */
209
- setMultiple(prefix: string, property: string, values: Record<string, TelemetryBaseEventPropertyType>): void;
210
- /**
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
- *
215
- * @param prefix - unique prefix for this data (ex: "fluid:map:")
216
- * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
217
- * @returns undefined if item not found
218
- */
219
- get(prefix: string, property: string): TelemetryBaseEventPropertyType;
220
- /**
221
- * Returns a serialized version of all the telemetry data.
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.
226
- */
227
- serialize(): string;
228
- }
229
-
230
- /* Excluded from this release type: LocalAttributionKey */
231
-
232
- /* Excluded from this release type: NamedFluidDataStoreRegistryEntries */
233
-
234
- /* Excluded from this release type: NamedFluidDataStoreRegistryEntry */
235
-
236
- /* Excluded from this release type: OpAttributionKey */
237
-
238
- /* Excluded from this release type: SummarizeInternalFn */
239
-
240
- /* Excluded from this release type: totalBlobSizePropertyName */
241
-
242
- /* Excluded from this release type: VisibilityState */
243
-
244
- export { }
@@ -1,244 +0,0 @@
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';
23
- import type { IUser } from '@fluidframework/protocol-definitions';
24
- import type { SummaryTree } from '@fluidframework/protocol-definitions';
25
- import type { TelemetryBaseEventPropertyType } from '@fluidframework/core-interfaces';
26
-
27
- /* Excluded from this release type: AliasResult */
28
-
29
- /* Excluded from this release type: AttributionInfo */
30
-
31
- /* Excluded from this release type: AttributionKey */
32
-
33
- /* Excluded from this release type: blobCountPropertyName */
34
-
35
- /* Excluded from this release type: channelsTreeName */
36
-
37
- /* Excluded from this release type: CreateChildSummarizerNodeFn */
38
-
39
- /* Excluded from this release type: CreateChildSummarizerNodeParam */
40
-
41
- /* Excluded from this release type: CreateSummarizerNodeSource */
42
-
43
- /* Excluded from this release type: DetachedAttributionKey */
44
-
45
- /* Excluded from this release type: FluidDataStoreRegistryEntry */
46
-
47
- /* Excluded from this release type: FlushMode */
48
-
49
- /* Excluded from this release type: FlushModeExperimental */
50
-
51
- /* Excluded from this release type: gcBlobPrefix */
52
-
53
- /* Excluded from this release type: gcDataBlobKey */
54
-
55
- /* Excluded from this release type: gcDeletedBlobKey */
56
-
57
- /* Excluded from this release type: gcTombstoneBlobKey */
58
-
59
- /* Excluded from this release type: gcTreeKey */
60
-
61
- /* Excluded from this release type: IAttachMessage */
62
-
63
- /* Excluded from this release type: IContainerRuntimeBase */
64
-
65
- /* Excluded from this release type: IContainerRuntimeBaseEvents */
66
-
67
- /* Excluded from this release type: IDataStore */
68
-
69
- /* Excluded from this release type: IDocumentStorageService */
70
-
71
- /* Excluded from this release type: IEnvelope */
72
-
73
- /**
74
- * @experimental - Can be deleted/changed at any time
75
- * Contains the necessary information to allow DDSes to do incremental summaries
76
- * @public
77
- */
78
- export declare interface IExperimentalIncrementalSummaryContext {
79
- /**
80
- * The sequence number of the summary generated that will be sent to the server.
81
- */
82
- summarySequenceNumber: number;
83
- /**
84
- * The sequence number of the most recent summary that was acknowledged by the server.
85
- */
86
- latestSummarySequenceNumber: number;
87
- /**
88
- * The path to the runtime/datastore/dds that is used to generate summary handles
89
- * Note: Summary handles are nodes of the summary tree that point to previous parts of the last successful summary
90
- * instead of being a blob or tree node
91
- *
92
- * This path contains the id of the data store and dds which should not be leaked to layers below them. Ideally,
93
- * a layer should not know its own id. This is important for channel unification work and there has been a lot of
94
- * work to remove these kinds of leakages. Some still exist, which have to be fixed but we should not be adding
95
- * more dependencies.
96
- */
97
- summaryPath: string;
98
- }
99
-
100
- /* Excluded from this release type: IFluidDataStoreChannel */
101
-
102
- /* Excluded from this release type: IFluidDataStoreContext */
103
-
104
- /* Excluded from this release type: IFluidDataStoreContextDetached */
105
-
106
- /* Excluded from this release type: IFluidDataStoreContextEvents */
107
-
108
- /* Excluded from this release type: IFluidDataStoreFactory */
109
-
110
- /* Excluded from this release type: IFluidDataStoreRegistry */
111
-
112
- /* Excluded from this release type: IFluidParentContext */
113
-
114
- /**
115
- * Garbage collection data returned by nodes in a Container.
116
- * Used for running GC in the Container.
117
- * @public
118
- */
119
- export declare interface IGarbageCollectionData {
120
- /**
121
- * The GC nodes of a Fluid object in the Container. Each node has an id and a set of routes to other GC nodes.
122
- */
123
- gcNodes: {
124
- [id: string]: string[];
125
- };
126
- }
127
-
128
- /* Excluded from this release type: IGarbageCollectionDetailsBase */
129
-
130
- /**
131
- * Represents ISignalMessage with its type.
132
- * @public
133
- */
134
- export declare interface IInboundSignalMessage extends ISignalMessage {
135
- type: string;
136
- }
137
-
138
- /* Excluded from this release type: InboundAttachMessage */
139
-
140
- /* Excluded from this release type: IProvideFluidDataStoreFactory */
141
-
142
- /* Excluded from this release type: IProvideFluidDataStoreRegistry */
143
-
144
- /* Excluded from this release type: ISignalEnvelope */
145
-
146
- /* Excluded from this release type: ISummarizeInternalResult */
147
-
148
- /* Excluded from this release type: ISummarizeResult */
149
-
150
- /* Excluded from this release type: ISummarizerNode */
151
-
152
- /* Excluded from this release type: ISummarizerNodeConfig */
153
-
154
- /* Excluded from this release type: ISummarizerNodeConfigWithGC */
155
-
156
- /* Excluded from this release type: ISummarizerNodeWithGC */
157
-
158
- /**
159
- * Contains the aggregation data from a Tree/Subtree.
160
- * @public
161
- */
162
- export declare interface ISummaryStats {
163
- treeNodeCount: number;
164
- blobNodeCount: number;
165
- handleNodeCount: number;
166
- totalBlobSize: number;
167
- unreferencedBlobSize: number;
168
- }
169
-
170
- /**
171
- * Represents the summary tree for a node along with the statistics for that tree.
172
- * For example, for a given data store, it contains the data for data store along with a subtree for
173
- * each of its DDS.
174
- * Any component that implements IChannelContext, IFluidDataStoreChannel or extends SharedObject
175
- * will be taking part of the summarization process.
176
- * @public
177
- */
178
- export declare interface ISummaryTreeWithStats {
179
- /**
180
- * Represents an aggregation of node counts and blob sizes associated to the current summary information
181
- */
182
- stats: ISummaryStats;
183
- /**
184
- * A recursive data structure that will be converted to a snapshot tree and uploaded
185
- * to the backend.
186
- */
187
- summary: ISummaryTree;
188
- }
189
-
190
- /**
191
- * Contains telemetry data relevant to summarization workflows.
192
- * This object is expected to be modified directly by various summarize methods.
193
- * @public
194
- */
195
- export declare interface ITelemetryContext {
196
- /**
197
- * Sets value for telemetry data being tracked.
198
- * @param prefix - unique prefix to tag this data with (ex: "fluid:map:")
199
- * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
200
- * @param value - value to attribute to this summary telemetry data
201
- */
202
- set(prefix: string, property: string, value: TelemetryBaseEventPropertyType): void;
203
- /**
204
- * Sets multiple values for telemetry data being tracked.
205
- * @param prefix - unique prefix to tag this data with (ex: "fluid:summarize:")
206
- * @param property - property name of the telemetry data being tracked (ex: "Options")
207
- * @param values - A set of values to attribute to this summary telemetry data.
208
- */
209
- setMultiple(prefix: string, property: string, values: Record<string, TelemetryBaseEventPropertyType>): void;
210
- /**
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
- *
215
- * @param prefix - unique prefix for this data (ex: "fluid:map:")
216
- * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
217
- * @returns undefined if item not found
218
- */
219
- get(prefix: string, property: string): TelemetryBaseEventPropertyType;
220
- /**
221
- * Returns a serialized version of all the telemetry data.
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.
226
- */
227
- serialize(): string;
228
- }
229
-
230
- /* Excluded from this release type: LocalAttributionKey */
231
-
232
- /* Excluded from this release type: NamedFluidDataStoreRegistryEntries */
233
-
234
- /* Excluded from this release type: NamedFluidDataStoreRegistryEntry */
235
-
236
- /* Excluded from this release type: OpAttributionKey */
237
-
238
- /* Excluded from this release type: SummarizeInternalFn */
239
-
240
- /* Excluded from this release type: totalBlobSizePropertyName */
241
-
242
- /* Excluded from this release type: VisibilityState */
243
-
244
- export { }