@fluidframework/driver-definitions 2.0.0-dev.7.4.0.216897 → 2.0.0-dev.7.4.0.217212

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.
@@ -27,7 +27,7 @@ import { IVersion } from '@fluidframework/protocol-definitions';
27
27
  // @internal (undocumented)
28
28
  export type DriverError = IThrottlingWarning | IGenericNetworkError | IAuthorizationError | ILocationRedirectionError | IDriverBasicError;
29
29
 
30
- // @internal @deprecated
30
+ // @alpha @deprecated
31
31
  export enum DriverErrorType {
32
32
  authorizationError = "authorizationError",
33
33
  deltaStreamConnectionForbidden = "deltaStreamConnectionForbidden",
@@ -89,7 +89,7 @@ export interface DriverPreCheckInfo {
89
89
  criticalBootDomains?: string[];
90
90
  }
91
91
 
92
- // @internal (undocumented)
92
+ // @alpha (undocumented)
93
93
  export enum FetchSource {
94
94
  // (undocumented)
95
95
  default = "default",
@@ -97,10 +97,10 @@ export enum FetchSource {
97
97
  noCache = "noCache"
98
98
  }
99
99
 
100
- // @internal (undocumented)
100
+ // @alpha (undocumented)
101
101
  export type FiveDaysMs = 432000000;
102
102
 
103
- // @internal
103
+ // @alpha
104
104
  export interface IAnyDriverError extends Omit<IDriverErrorBase, "errorType"> {
105
105
  // (undocumented)
106
106
  readonly errorType: string;
@@ -116,7 +116,7 @@ export interface IAuthorizationError extends IDriverErrorBase {
116
116
  readonly tenantId?: string;
117
117
  }
118
118
 
119
- // @internal
119
+ // @alpha
120
120
  export interface IContainerPackageInfo {
121
121
  name: string;
122
122
  }
@@ -134,7 +134,7 @@ export interface IDeltaStorageService {
134
134
  fetchReason?: string): Promise<IDeltasFetchResult>;
135
135
  }
136
136
 
137
- // @internal (undocumented)
137
+ // @alpha (undocumented)
138
138
  export interface IDocumentDeltaConnection extends IDisposable, IEventProvider<IDocumentDeltaConnectionEvents> {
139
139
  checkpointSequenceNumber?: number;
140
140
  claims: ITokenClaims;
@@ -151,7 +151,7 @@ export interface IDocumentDeltaConnection extends IDisposable, IEventProvider<ID
151
151
  version: string;
152
152
  }
153
153
 
154
- // @internal (undocumented)
154
+ // @alpha (undocumented)
155
155
  export interface IDocumentDeltaConnectionEvents extends IErrorEvent {
156
156
  // (undocumented)
157
157
  (event: "nack", listener: (documentId: string, message: INack[]) => void): any;
@@ -167,12 +167,12 @@ export interface IDocumentDeltaConnectionEvents extends IErrorEvent {
167
167
  (event: "error", listener: (error: any) => void): any;
168
168
  }
169
169
 
170
- // @internal
170
+ // @alpha
171
171
  export interface IDocumentDeltaStorageService {
172
172
  fetchMessages(from: number, to: number | undefined, abortSignal?: AbortSignal, cachedOnly?: boolean, fetchReason?: string): IStream<ISequencedDocumentMessage[]>;
173
173
  }
174
174
 
175
- // @internal (undocumented)
175
+ // @alpha (undocumented)
176
176
  export interface IDocumentService {
177
177
  connectToDeltaStorage(): Promise<IDocumentDeltaStorageService>;
178
178
  connectToDeltaStream(client: IClient): Promise<IDocumentDeltaConnection>;
@@ -183,19 +183,19 @@ export interface IDocumentService {
183
183
  resolvedUrl: IResolvedUrl;
184
184
  }
185
185
 
186
- // @internal (undocumented)
186
+ // @alpha (undocumented)
187
187
  export interface IDocumentServiceFactory {
188
188
  createContainer(createNewSummary: ISummaryTree | undefined, createNewResolvedUrl: IResolvedUrl, logger?: ITelemetryBaseLogger, clientIsSummarizer?: boolean): Promise<IDocumentService>;
189
189
  createDocumentService(resolvedUrl: IResolvedUrl, logger?: ITelemetryBaseLogger, clientIsSummarizer?: boolean): Promise<IDocumentService>;
190
190
  }
191
191
 
192
- // @internal (undocumented)
192
+ // @alpha (undocumented)
193
193
  export interface IDocumentServicePolicies {
194
194
  readonly storageOnly?: boolean;
195
195
  readonly summarizeProtocolTree?: boolean;
196
196
  }
197
197
 
198
- // @internal
198
+ // @alpha
199
199
  export interface IDocumentStorageService extends Partial<IDisposable> {
200
200
  createBlob(file: ArrayBufferLike): Promise<ICreateBlobResponse>;
201
201
  downloadSummary(handle: ISummaryHandle): Promise<ISummaryTree>;
@@ -208,7 +208,7 @@ export interface IDocumentStorageService extends Partial<IDisposable> {
208
208
  uploadSummaryWithContext(summary: ISummaryTree, context: ISummaryContext): Promise<string>;
209
209
  }
210
210
 
211
- // @internal
211
+ // @alpha
212
212
  export interface IDocumentStorageServicePolicies {
213
213
  readonly caching?: LoaderCachingPolicy;
214
214
  readonly maximumCacheDurationMs?: FiveDaysMs;
@@ -222,7 +222,7 @@ export interface IDriverBasicError extends IDriverErrorBase {
222
222
  readonly statusCode?: number;
223
223
  }
224
224
 
225
- // @internal
225
+ // @alpha
226
226
  export interface IDriverErrorBase {
227
227
  canRetry: boolean;
228
228
  endpointReached?: boolean;
@@ -255,7 +255,7 @@ export interface ILocationRedirectionError extends IDriverErrorBase {
255
255
  readonly redirectUrl: IResolvedUrl;
256
256
  }
257
257
 
258
- // @internal (undocumented)
258
+ // @alpha (undocumented)
259
259
  export interface IResolvedUrl {
260
260
  // (undocumented)
261
261
  endpoints: {
@@ -272,13 +272,13 @@ export interface IResolvedUrl {
272
272
  url: string;
273
273
  }
274
274
 
275
- // @internal
275
+ // @alpha
276
276
  export interface IStream<T> {
277
277
  // (undocumented)
278
278
  read(): Promise<IStreamResult<T>>;
279
279
  }
280
280
 
281
- // @internal (undocumented)
281
+ // @alpha (undocumented)
282
282
  export type IStreamResult<T> = {
283
283
  done: true;
284
284
  } | {
@@ -286,7 +286,7 @@ export type IStreamResult<T> = {
286
286
  value: T;
287
287
  };
288
288
 
289
- // @internal
289
+ // @alpha
290
290
  export interface ISummaryContext {
291
291
  readonly ackHandle: string | undefined;
292
292
  readonly proposalHandle: string | undefined;
@@ -302,14 +302,14 @@ export interface IThrottlingWarning extends IDriverErrorBase {
302
302
  readonly retryAfterSeconds: number;
303
303
  }
304
304
 
305
- // @internal (undocumented)
305
+ // @alpha (undocumented)
306
306
  export interface IUrlResolver {
307
307
  getAbsoluteUrl(resolvedUrl: IResolvedUrl, relativeUrl: string, packageInfoSource?: IContainerPackageInfo): Promise<string>;
308
308
  // (undocumented)
309
309
  resolve(request: IRequest): Promise<IResolvedUrl | undefined>;
310
310
  }
311
311
 
312
- // @internal (undocumented)
312
+ // @alpha (undocumented)
313
313
  export enum LoaderCachingPolicy {
314
314
  NoCaching = 0,
315
315
  Prefetch = 1