@fluidframework/core-interfaces 2.0.0-dev.7.4.0.215930 → 2.0.0-dev.7.4.0.216897

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 (87) hide show
  1. package/api-extractor-lint.json +13 -0
  2. package/api-extractor.json +0 -4
  3. package/api-report/core-interfaces.api.md +61 -61
  4. package/dist/core-interfaces-alpha.d.ts +105 -905
  5. package/dist/core-interfaces-beta.d.ts +105 -905
  6. package/dist/core-interfaces-public.d.ts +105 -905
  7. package/dist/core-interfaces-untrimmed.d.ts +87 -3
  8. package/dist/disposable.d.ts +1 -0
  9. package/dist/disposable.d.ts.map +1 -1
  10. package/dist/disposable.js.map +1 -1
  11. package/dist/error.d.ts +8 -0
  12. package/dist/error.d.ts.map +1 -1
  13. package/dist/error.js +1 -0
  14. package/dist/error.js.map +1 -1
  15. package/dist/events.d.ts +8 -1
  16. package/dist/events.d.ts.map +1 -1
  17. package/dist/events.js.map +1 -1
  18. package/dist/fluidLoadable.d.ts +16 -0
  19. package/dist/fluidLoadable.d.ts.map +1 -1
  20. package/dist/fluidLoadable.js +6 -0
  21. package/dist/fluidLoadable.js.map +1 -1
  22. package/dist/fluidPackage.d.ts +9 -0
  23. package/dist/fluidPackage.d.ts.map +1 -1
  24. package/dist/fluidPackage.js +3 -0
  25. package/dist/fluidPackage.js.map +1 -1
  26. package/dist/fluidRouter.d.ts +12 -0
  27. package/dist/fluidRouter.d.ts.map +1 -1
  28. package/dist/fluidRouter.js +1 -0
  29. package/dist/fluidRouter.js.map +1 -1
  30. package/dist/handles.d.ts +14 -0
  31. package/dist/handles.d.ts.map +1 -1
  32. package/dist/handles.js +6 -0
  33. package/dist/handles.js.map +1 -1
  34. package/dist/logger.d.ts +16 -0
  35. package/dist/logger.d.ts.map +1 -1
  36. package/dist/logger.js +1 -0
  37. package/dist/logger.js.map +1 -1
  38. package/dist/provider.d.ts +3 -2
  39. package/dist/provider.d.ts.map +1 -1
  40. package/dist/provider.js.map +1 -1
  41. package/lib/core-interfaces-alpha.d.ts +105 -905
  42. package/lib/core-interfaces-beta.d.ts +105 -905
  43. package/lib/core-interfaces-public.d.ts +105 -905
  44. package/lib/core-interfaces-untrimmed.d.ts +87 -3
  45. package/lib/disposable.d.ts +1 -0
  46. package/lib/disposable.d.ts.map +1 -1
  47. package/lib/disposable.js.map +1 -1
  48. package/lib/error.d.ts +8 -0
  49. package/lib/error.d.ts.map +1 -1
  50. package/lib/error.js +1 -0
  51. package/lib/error.js.map +1 -1
  52. package/lib/events.d.ts +8 -1
  53. package/lib/events.d.ts.map +1 -1
  54. package/lib/events.js.map +1 -1
  55. package/lib/fluidLoadable.d.ts +16 -0
  56. package/lib/fluidLoadable.d.ts.map +1 -1
  57. package/lib/fluidLoadable.js +6 -0
  58. package/lib/fluidLoadable.js.map +1 -1
  59. package/lib/fluidPackage.d.ts +9 -0
  60. package/lib/fluidPackage.d.ts.map +1 -1
  61. package/lib/fluidPackage.js +3 -0
  62. package/lib/fluidPackage.js.map +1 -1
  63. package/lib/fluidRouter.d.ts +12 -0
  64. package/lib/fluidRouter.d.ts.map +1 -1
  65. package/lib/fluidRouter.js +1 -0
  66. package/lib/fluidRouter.js.map +1 -1
  67. package/lib/handles.d.ts +14 -0
  68. package/lib/handles.d.ts.map +1 -1
  69. package/lib/handles.js +6 -0
  70. package/lib/handles.js.map +1 -1
  71. package/lib/logger.d.ts +16 -0
  72. package/lib/logger.d.ts.map +1 -1
  73. package/lib/logger.js +1 -0
  74. package/lib/logger.js.map +1 -1
  75. package/lib/provider.d.ts +3 -2
  76. package/lib/provider.d.ts.map +1 -1
  77. package/lib/provider.js.map +1 -1
  78. package/package.json +3 -2
  79. package/src/disposable.ts +1 -0
  80. package/src/error.ts +8 -0
  81. package/src/events.ts +8 -1
  82. package/src/fluidLoadable.ts +16 -0
  83. package/src/fluidPackage.ts +9 -0
  84. package/src/fluidRouter.ts +12 -0
  85. package/src/handles.ts +14 -0
  86. package/src/logger.ts +16 -0
  87. package/src/provider.ts +3 -2
@@ -0,0 +1,13 @@
1
+ {
2
+ "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
3
+ "extends": "../../../common/build/build-common/api-extractor-lint.json",
4
+ "messages": {
5
+ "extractorMessageReporting": {
6
+ // TODO: remove once base config has this enabled as an error
7
+ "ae-incompatible-release-tags": {
8
+ "logLevel": "error",
9
+ "addToApiReportFile": false
10
+ }
11
+ }
12
+ }
13
+ }
@@ -3,10 +3,6 @@
3
3
  "extends": "../../../common/build/build-common/api-extractor-base.json",
4
4
  "messages": {
5
5
  "extractorMessageReporting": {
6
- "ae-missing-release-tag": {
7
- // TODO: Fix violations and remove this rule override
8
- "logLevel": "none"
9
- },
10
6
  // TODO: Add missing documentation and remove this rule override
11
7
  "ae-undocumented": {
12
8
  "logLevel": "none"
@@ -4,10 +4,10 @@
4
4
 
5
5
  ```ts
6
6
 
7
- // @public
7
+ // @internal
8
8
  export type ExtendEventProvider<TBaseEvent extends IEvent, TBase extends IEventProvider<TBaseEvent>, TEvent extends TBaseEvent> = Omit<Omit<Omit<TBase, "on">, "once">, "off"> & IEventProvider<TBaseEvent> & IEventProvider<TEvent>;
9
9
 
10
- // @public
10
+ // @internal
11
11
  export const FluidErrorTypes: {
12
12
  readonly genericError: "genericError";
13
13
  readonly throttlingError: "throttlingError";
@@ -16,27 +16,27 @@ export const FluidErrorTypes: {
16
16
  readonly usageError: "usageError";
17
17
  };
18
18
 
19
- // @public (undocumented)
19
+ // @internal (undocumented)
20
20
  export type FluidErrorTypes = (typeof FluidErrorTypes)[keyof typeof FluidErrorTypes];
21
21
 
22
- // @public
22
+ // @internal
23
23
  export type FluidObject<T = unknown> = {
24
24
  [P in FluidObjectProviderKeys<T>]?: T[P];
25
25
  };
26
26
 
27
- // @public
27
+ // @internal
28
28
  export type FluidObjectKeys<T> = keyof FluidObject<T>;
29
29
 
30
- // @public
30
+ // @internal
31
31
  export type FluidObjectProviderKeys<T, TProp extends keyof T = keyof T> = string extends TProp ? never : number extends TProp ? never : TProp extends keyof Required<T>[TProp] ? Required<T>[TProp] extends Required<Required<T>[TProp]>[TProp] ? TProp : never : never;
32
32
 
33
- // @public
33
+ // @internal
34
34
  export interface IDisposable {
35
35
  dispose(error?: Error): void;
36
36
  readonly disposed: boolean;
37
37
  }
38
38
 
39
- // @public
39
+ // @internal
40
40
  export interface IErrorBase extends Partial<Error> {
41
41
  readonly errorType: string;
42
42
  getTelemetryProperties?(): ITelemetryBaseProperties;
@@ -45,31 +45,31 @@ export interface IErrorBase extends Partial<Error> {
45
45
  readonly stack?: string;
46
46
  }
47
47
 
48
- // @public
48
+ // @internal
49
49
  export interface IErrorEvent extends IEvent {
50
50
  // @eventProperty
51
51
  (event: "error", listener: (message: any) => void): any;
52
52
  }
53
53
 
54
- // @public
54
+ // @internal
55
55
  export interface IEvent {
56
56
  // @eventProperty
57
57
  (event: string, listener: (...args: any[]) => void): any;
58
58
  }
59
59
 
60
- // @public
60
+ // @internal
61
61
  export interface IEventProvider<TEvent extends IEvent> {
62
62
  readonly off: IEventTransformer<this, TEvent>;
63
63
  readonly on: IEventTransformer<this, TEvent>;
64
64
  readonly once: IEventTransformer<this, TEvent>;
65
65
  }
66
66
 
67
- // @public
67
+ // @internal
68
68
  export type IEventThisPlaceHolder = {
69
69
  thisPlaceHolder: "thisPlaceHolder";
70
70
  };
71
71
 
72
- // @public
72
+ // @internal
73
73
  export type IEventTransformer<TThis, TEvent extends IEvent> = TEvent extends {
74
74
  (event: infer E0, listener: (...args: infer A0) => void): any;
75
75
  (event: infer E1, listener: (...args: infer A1) => void): any;
@@ -222,31 +222,31 @@ export type IEventTransformer<TThis, TEvent extends IEvent> = TEvent extends {
222
222
  (event: string, listener: (...args: any[]) => void): any;
223
223
  } ? TransformedEvent<TThis, E0, A0> : TransformedEvent<TThis, string, any[]>;
224
224
 
225
- // @public @deprecated
225
+ // @internal @deprecated
226
226
  export interface IFluidCodeDetails {
227
227
  readonly config?: IFluidCodeDetailsConfig;
228
228
  readonly package: string | Readonly<IFluidPackage>;
229
229
  }
230
230
 
231
- // @public @deprecated (undocumented)
231
+ // @internal @deprecated (undocumented)
232
232
  export const IFluidCodeDetailsComparer: keyof IProvideFluidCodeDetailsComparer;
233
233
 
234
- // @public @deprecated
234
+ // @internal @deprecated
235
235
  export interface IFluidCodeDetailsComparer extends IProvideFluidCodeDetailsComparer {
236
236
  compare(a: IFluidCodeDetails, b: IFluidCodeDetails): Promise<number | undefined>;
237
237
  satisfies(candidate: IFluidCodeDetails, constraint: IFluidCodeDetails): Promise<boolean>;
238
238
  }
239
239
 
240
- // @public @deprecated
240
+ // @internal @deprecated
241
241
  export interface IFluidCodeDetailsConfig {
242
242
  // (undocumented)
243
243
  readonly [key: string]: string;
244
244
  }
245
245
 
246
- // @public (undocumented)
246
+ // @internal (undocumented)
247
247
  export const IFluidHandle: keyof IProvideFluidHandle;
248
248
 
249
- // @public
249
+ // @internal
250
250
  export interface IFluidHandle<T = FluidObject & IFluidLoadable> extends IProvideFluidHandle {
251
251
  // @deprecated (undocumented)
252
252
  readonly absolutePath: string;
@@ -258,10 +258,10 @@ export interface IFluidHandle<T = FluidObject & IFluidLoadable> extends IProvide
258
258
  readonly isAttached: boolean;
259
259
  }
260
260
 
261
- // @public (undocumented)
261
+ // @internal (undocumented)
262
262
  export const IFluidHandleContext: keyof IProvideFluidHandleContext;
263
263
 
264
- // @public
264
+ // @internal
265
265
  export interface IFluidHandleContext extends IProvideFluidHandleContext {
266
266
  readonly absolutePath: string;
267
267
  attachGraph(): void;
@@ -271,16 +271,16 @@ export interface IFluidHandleContext extends IProvideFluidHandleContext {
271
271
  readonly routeContext?: IFluidHandleContext;
272
272
  }
273
273
 
274
- // @public (undocumented)
274
+ // @internal (undocumented)
275
275
  export const IFluidLoadable: keyof IProvideFluidLoadable;
276
276
 
277
- // @public
277
+ // @internal
278
278
  export interface IFluidLoadable extends IProvideFluidLoadable {
279
279
  // (undocumented)
280
280
  handle: IFluidHandle;
281
281
  }
282
282
 
283
- // @public @deprecated
283
+ // @internal @deprecated
284
284
  export interface IFluidPackage {
285
285
  [key: string]: unknown;
286
286
  fluid: {
@@ -289,7 +289,7 @@ export interface IFluidPackage {
289
289
  name: string;
290
290
  }
291
291
 
292
- // @public @deprecated
292
+ // @internal @deprecated
293
293
  export interface IFluidPackageEnvironment {
294
294
  [target: string]: undefined | {
295
295
  files: string[];
@@ -297,19 +297,19 @@ export interface IFluidPackageEnvironment {
297
297
  };
298
298
  }
299
299
 
300
- // @public @deprecated (undocumented)
300
+ // @internal @deprecated (undocumented)
301
301
  export const IFluidRouter: keyof IProvideFluidRouter;
302
302
 
303
- // @public @deprecated (undocumented)
303
+ // @internal @deprecated (undocumented)
304
304
  export interface IFluidRouter extends IProvideFluidRouter {
305
305
  // (undocumented)
306
306
  request(request: IRequest): Promise<IResponse>;
307
307
  }
308
308
 
309
- // @public (undocumented)
309
+ // @internal (undocumented)
310
310
  export const IFluidRunnable: keyof IProvideFluidRunnable;
311
311
 
312
- // @public (undocumented)
312
+ // @internal (undocumented)
313
313
  export interface IFluidRunnable {
314
314
  // (undocumented)
315
315
  run(...args: any[]): Promise<void>;
@@ -317,55 +317,55 @@ export interface IFluidRunnable {
317
317
  stop(reason?: string): void;
318
318
  }
319
319
 
320
- // @public
320
+ // @internal
321
321
  export interface IGenericError extends IErrorBase {
322
322
  // (undocumented)
323
323
  error?: any;
324
324
  readonly errorType: typeof FluidErrorTypes.genericError;
325
325
  }
326
326
 
327
- // @public
327
+ // @internal
328
328
  export interface ILoggingError extends Error {
329
329
  getTelemetryProperties(): ITelemetryBaseProperties;
330
330
  }
331
331
 
332
- // @public @deprecated (undocumented)
332
+ // @internal @deprecated (undocumented)
333
333
  export interface IProvideFluidCodeDetailsComparer {
334
334
  // (undocumented)
335
335
  readonly IFluidCodeDetailsComparer: IFluidCodeDetailsComparer;
336
336
  }
337
337
 
338
- // @public (undocumented)
338
+ // @internal (undocumented)
339
339
  export interface IProvideFluidHandle {
340
340
  // (undocumented)
341
341
  readonly IFluidHandle: IFluidHandle;
342
342
  }
343
343
 
344
- // @public (undocumented)
344
+ // @internal (undocumented)
345
345
  export interface IProvideFluidHandleContext {
346
346
  // (undocumented)
347
347
  readonly IFluidHandleContext: IFluidHandleContext;
348
348
  }
349
349
 
350
- // @public (undocumented)
350
+ // @internal (undocumented)
351
351
  export interface IProvideFluidLoadable {
352
352
  // (undocumented)
353
353
  readonly IFluidLoadable: IFluidLoadable;
354
354
  }
355
355
 
356
- // @public @deprecated
356
+ // @internal @deprecated
357
357
  export interface IProvideFluidRouter {
358
358
  // (undocumented)
359
359
  readonly IFluidRouter: IFluidRouter;
360
360
  }
361
361
 
362
- // @public (undocumented)
362
+ // @internal (undocumented)
363
363
  export interface IProvideFluidRunnable {
364
364
  // (undocumented)
365
365
  readonly IFluidRunnable: IFluidRunnable;
366
366
  }
367
367
 
368
- // @public (undocumented)
368
+ // @internal (undocumented)
369
369
  export interface IRequest {
370
370
  // (undocumented)
371
371
  headers?: IRequestHeader;
@@ -373,13 +373,13 @@ export interface IRequest {
373
373
  url: string;
374
374
  }
375
375
 
376
- // @public (undocumented)
376
+ // @internal (undocumented)
377
377
  export interface IRequestHeader {
378
378
  // (undocumented)
379
379
  [index: string]: any;
380
380
  }
381
381
 
382
- // @public (undocumented)
382
+ // @internal (undocumented)
383
383
  export interface IResponse {
384
384
  // (undocumented)
385
385
  headers?: {
@@ -395,13 +395,13 @@ export interface IResponse {
395
395
  value: any;
396
396
  }
397
397
 
398
- // @public @deprecated (undocumented)
398
+ // @internal @deprecated (undocumented)
399
399
  export const isFluidCodeDetails: (details: unknown) => details is Readonly<IFluidCodeDetails>;
400
400
 
401
- // @public @deprecated
401
+ // @internal @deprecated
402
402
  export const isFluidPackage: (pkg: unknown) => pkg is Readonly<IFluidPackage>;
403
403
 
404
- // @public @deprecated (undocumented)
404
+ // @internal @deprecated (undocumented)
405
405
  export interface ITaggedTelemetryPropertyType {
406
406
  // (undocumented)
407
407
  tag: string;
@@ -409,7 +409,7 @@ export interface ITaggedTelemetryPropertyType {
409
409
  value: TelemetryEventPropertyType;
410
410
  }
411
411
 
412
- // @public
412
+ // @internal
413
413
  export interface ITelemetryBaseEvent extends ITelemetryBaseProperties {
414
414
  // (undocumented)
415
415
  category: string;
@@ -417,7 +417,7 @@ export interface ITelemetryBaseEvent extends ITelemetryBaseProperties {
417
417
  eventName: string;
418
418
  }
419
419
 
420
- // @public
420
+ // @internal
421
421
  export interface ITelemetryBaseLogger {
422
422
  // (undocumented)
423
423
  minLogLevel?: LogLevel;
@@ -425,16 +425,16 @@ export interface ITelemetryBaseLogger {
425
425
  send(event: ITelemetryBaseEvent, logLevel?: LogLevel): void;
426
426
  }
427
427
 
428
- // @public
428
+ // @internal
429
429
  export type ITelemetryBaseProperties = ITelemetryProperties;
430
430
 
431
- // @public @deprecated
431
+ // @internal @deprecated
432
432
  export interface ITelemetryErrorEvent extends ITelemetryProperties {
433
433
  // (undocumented)
434
434
  eventName: string;
435
435
  }
436
436
 
437
- // @public @deprecated
437
+ // @internal @deprecated
438
438
  export interface ITelemetryGenericEvent extends ITelemetryProperties {
439
439
  // (undocumented)
440
440
  category?: TelemetryEventCategory;
@@ -442,7 +442,7 @@ export interface ITelemetryGenericEvent extends ITelemetryProperties {
442
442
  eventName: string;
443
443
  }
444
444
 
445
- // @public @deprecated
445
+ // @internal @deprecated
446
446
  export interface ITelemetryLogger extends ITelemetryBaseLogger {
447
447
  send(event: ITelemetryBaseEvent, logLevel?: LogLevel): void;
448
448
  sendErrorEvent(event: ITelemetryErrorEvent, error?: any): void;
@@ -450,46 +450,46 @@ export interface ITelemetryLogger extends ITelemetryBaseLogger {
450
450
  sendTelemetryEvent(event: ITelemetryGenericEvent, error?: any, logLevel?: typeof LogLevel.verbose | typeof LogLevel.default): void;
451
451
  }
452
452
 
453
- // @public @deprecated
453
+ // @internal @deprecated
454
454
  export interface ITelemetryPerformanceEvent extends ITelemetryGenericEvent {
455
455
  // (undocumented)
456
456
  duration?: number;
457
457
  }
458
458
 
459
- // @public @deprecated
459
+ // @internal @deprecated
460
460
  export interface ITelemetryProperties {
461
461
  // (undocumented)
462
462
  [index: string]: TelemetryEventPropertyType | Tagged<TelemetryEventPropertyType>;
463
463
  }
464
464
 
465
- // @public
465
+ // @internal
466
466
  export interface IThrottlingWarning extends IErrorBase {
467
467
  readonly errorType: typeof FluidErrorTypes.throttlingError;
468
468
  // (undocumented)
469
469
  readonly retryAfterSeconds: number;
470
470
  }
471
471
 
472
- // @public
472
+ // @internal
473
473
  export interface IUsageError extends IErrorBase {
474
474
  readonly errorType: typeof FluidErrorTypes.usageError;
475
475
  }
476
476
 
477
- // @public
477
+ // @internal
478
478
  export const LogLevel: {
479
479
  readonly verbose: 10;
480
480
  readonly default: 20;
481
481
  readonly error: 30;
482
482
  };
483
483
 
484
- // @public
484
+ // @internal
485
485
  export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
486
486
 
487
- // @public
487
+ // @internal
488
488
  export type ReplaceIEventThisPlaceHolder<L extends any[], TThis> = L extends any[] ? {
489
489
  [K in keyof L]: L[K] extends IEventThisPlaceHolder ? TThis : L[K];
490
490
  } : L;
491
491
 
492
- // @public
492
+ // @internal
493
493
  export interface Tagged<V, T extends string = string> {
494
494
  // (undocumented)
495
495
  tag: T;
@@ -497,16 +497,16 @@ export interface Tagged<V, T extends string = string> {
497
497
  value: V;
498
498
  }
499
499
 
500
- // @public
500
+ // @internal
501
501
  export type TelemetryBaseEventPropertyType = TelemetryEventPropertyType;
502
502
 
503
- // @public @deprecated
503
+ // @internal @deprecated
504
504
  export type TelemetryEventCategory = "generic" | "error" | "performance";
505
505
 
506
- // @public @deprecated
506
+ // @internal @deprecated
507
507
  export type TelemetryEventPropertyType = string | number | boolean | undefined;
508
508
 
509
- // @public
509
+ // @internal
510
510
  export type TransformedEvent<TThis, E, A extends any[]> = (event: E, listener: (...args: ReplaceIEventThisPlaceHolder<A, TThis>) => void) => TThis;
511
511
 
512
512
  // (No @packageDocumentation comment for this package)