@fluidframework/container-runtime 2.0.0-dev.7.4.0.217212 → 2.0.0-dev.7.4.0.217884

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 (52) hide show
  1. package/api-report/container-runtime.api.md +55 -55
  2. package/dist/blobManager.d.ts +1 -1
  3. package/dist/blobManager.js.map +1 -1
  4. package/dist/container-runtime-alpha.d.ts +1340 -132
  5. package/dist/container-runtime-untrimmed.d.ts +55 -55
  6. package/dist/containerRuntime.d.ts +10 -10
  7. package/dist/containerRuntime.js +2 -2
  8. package/dist/containerRuntime.js.map +1 -1
  9. package/dist/gc/gcDefinitions.d.ts +9 -9
  10. package/dist/gc/gcDefinitions.js +1 -1
  11. package/dist/gc/gcDefinitions.js.map +1 -1
  12. package/dist/packageVersion.d.ts +1 -1
  13. package/dist/packageVersion.js +1 -1
  14. package/dist/packageVersion.js.map +1 -1
  15. package/dist/summary/orderedClientElection.d.ts +1 -1
  16. package/dist/summary/orderedClientElection.js.map +1 -1
  17. package/dist/summary/summarizerTypes.d.ts +28 -28
  18. package/dist/summary/summarizerTypes.js.map +1 -1
  19. package/dist/summary/summaryCollection.d.ts +3 -3
  20. package/dist/summary/summaryCollection.js.map +1 -1
  21. package/dist/summary/summaryFormat.d.ts +3 -3
  22. package/dist/summary/summaryFormat.js.map +1 -1
  23. package/lib/blobManager.d.ts +1 -1
  24. package/lib/blobManager.js.map +1 -1
  25. package/lib/container-runtime-alpha.d.ts +1340 -132
  26. package/lib/container-runtime-untrimmed.d.ts +55 -55
  27. package/lib/containerRuntime.d.ts +10 -10
  28. package/lib/containerRuntime.js +2 -2
  29. package/lib/containerRuntime.js.map +1 -1
  30. package/lib/gc/gcDefinitions.d.ts +9 -9
  31. package/lib/gc/gcDefinitions.js +1 -1
  32. package/lib/gc/gcDefinitions.js.map +1 -1
  33. package/lib/packageVersion.d.ts +1 -1
  34. package/lib/packageVersion.js +1 -1
  35. package/lib/packageVersion.js.map +1 -1
  36. package/lib/summary/orderedClientElection.d.ts +1 -1
  37. package/lib/summary/orderedClientElection.js.map +1 -1
  38. package/lib/summary/summarizerTypes.d.ts +28 -28
  39. package/lib/summary/summarizerTypes.js.map +1 -1
  40. package/lib/summary/summaryCollection.d.ts +3 -3
  41. package/lib/summary/summaryCollection.js.map +1 -1
  42. package/lib/summary/summaryFormat.d.ts +3 -3
  43. package/lib/summary/summaryFormat.js.map +1 -1
  44. package/package.json +15 -15
  45. package/src/blobManager.ts +1 -1
  46. package/src/containerRuntime.ts +10 -10
  47. package/src/gc/gcDefinitions.ts +9 -9
  48. package/src/packageVersion.ts +1 -1
  49. package/src/summary/orderedClientElection.ts +1 -1
  50. package/src/summary/summarizerTypes.ts +28 -28
  51. package/src/summary/summaryCollection.ts +3 -3
  52. package/src/summary/summaryFormat.ts +3 -3
@@ -72,7 +72,7 @@ export type CompatModeBehavior =
72
72
  /** Fail processing immediately. (The container will close) */
73
73
  | "FailToProcess";
74
74
 
75
- // @internal
75
+ // @alpha
76
76
  export enum CompressionAlgorithms {
77
77
  // (undocumented)
78
78
  lz4 = "lz4"
@@ -95,7 +95,7 @@ export enum ContainerMessageType {
95
95
  Rejoin = "rejoin"
96
96
  }
97
97
 
98
- // @internal
98
+ // @alpha
99
99
  export class ContainerRuntime extends TypedEventEmitter<IContainerRuntimeEvents & ISummarizerEvents> implements IContainerRuntime, IRuntime, ISummarizerRuntime, ISummarizerInternalsProvider, IProvideFluidHandleContext {
100
100
  protected constructor(context: IContainerContext, registry: IFluidDataStoreRegistry, metadata: IContainerRuntimeMetadata | undefined, electedSummarizerData: ISerializedElection | undefined, chunks: [string, string[]][], dataStoreAliasMap: [string, string][], runtimeOptions: Readonly<Required<IContainerRuntimeOptions>>, containerScope: FluidObject, logger: ITelemetryLoggerExt, existing: boolean, blobManagerSnapshot: IBlobManagerLoadInfo, _storage: IDocumentStorageService, idCompressor: (IIdCompressor & IIdCompressorCore) | undefined, provideEntryPoint: (containerRuntime: IContainerRuntime) => Promise<FluidObject>, requestHandler?: ((request: IRequest, runtime: IContainerRuntime) => Promise<IResponse>) | undefined, summaryConfiguration?: ISummaryConfiguration);
101
101
  // (undocumented)
@@ -242,7 +242,7 @@ export interface ContainerRuntimeMessage {
242
242
  // @internal (undocumented)
243
243
  export const DefaultSummaryConfiguration: ISummaryConfiguration;
244
244
 
245
- // @internal (undocumented)
245
+ // @alpha (undocumented)
246
246
  export type EnqueueSummarizeResult = (ISummarizeResults & {
247
247
  readonly alreadyEnqueued?: undefined;
248
248
  }) | (ISummarizeResults & {
@@ -262,13 +262,13 @@ export class FluidDataStoreRegistry implements IFluidDataStoreRegistry {
262
262
  get IFluidDataStoreRegistry(): this;
263
263
  }
264
264
 
265
- // @internal (undocumented)
265
+ // @alpha (undocumented)
266
266
  export interface GCFeatureMatrix {
267
267
  sweepGeneration?: number;
268
268
  tombstoneGeneration?: number;
269
269
  }
270
270
 
271
- // @internal
271
+ // @alpha
272
272
  export const GCNodeType: {
273
273
  DataStore: string;
274
274
  SubDataStore: string;
@@ -276,10 +276,10 @@ export const GCNodeType: {
276
276
  Other: string;
277
277
  };
278
278
 
279
- // @internal (undocumented)
279
+ // @alpha (undocumented)
280
280
  export type GCNodeType = (typeof GCNodeType)[keyof typeof GCNodeType];
281
281
 
282
- // @internal (undocumented)
282
+ // @alpha (undocumented)
283
283
  export type GCVersion = number;
284
284
 
285
285
  // @internal
@@ -293,7 +293,7 @@ export interface IAckedSummary {
293
293
  readonly summaryOp: ISummaryOpMessage;
294
294
  }
295
295
 
296
- // @internal (undocumented)
296
+ // @alpha (undocumented)
297
297
  export interface IAckSummaryResult {
298
298
  // (undocumented)
299
299
  readonly ackNackDuration: number;
@@ -301,7 +301,7 @@ export interface IAckSummaryResult {
301
301
  readonly summaryAckOp: ISummaryAckMessage;
302
302
  }
303
303
 
304
- // @internal
304
+ // @alpha
305
305
  export interface IBaseSummarizeResult {
306
306
  readonly error: any;
307
307
  // (undocumented)
@@ -311,7 +311,7 @@ export interface IBaseSummarizeResult {
311
311
  readonly stage: "base";
312
312
  }
313
313
 
314
- // @internal
314
+ // @alpha
315
315
  export interface IBlobManagerLoadInfo {
316
316
  // (undocumented)
317
317
  ids?: string[];
@@ -319,7 +319,7 @@ export interface IBlobManagerLoadInfo {
319
319
  redirectTable?: [string, string][];
320
320
  }
321
321
 
322
- // @internal (undocumented)
322
+ // @alpha (undocumented)
323
323
  export interface IBroadcastSummaryResult {
324
324
  // (undocumented)
325
325
  readonly broadcastDuration: number;
@@ -333,7 +333,7 @@ export interface ICancellableSummarizerController extends ISummaryCancellationTo
333
333
  stop(reason: SummarizerStopReason): void;
334
334
  }
335
335
 
336
- // @internal
336
+ // @alpha
337
337
  export interface ICancellationToken<T> {
338
338
  readonly cancelled: boolean;
339
339
  readonly waitCancelled: Promise<T>;
@@ -363,13 +363,13 @@ export interface IClientSummaryWatcher extends IDisposable {
363
363
  watchSummary(clientSequenceNumber: number): ISummary;
364
364
  }
365
365
 
366
- // @internal
366
+ // @alpha
367
367
  export interface ICompressionRuntimeOptions {
368
368
  readonly compressionAlgorithm: CompressionAlgorithms;
369
369
  readonly minimumBatchSizeInBytes: number;
370
370
  }
371
371
 
372
- // @internal (undocumented)
372
+ // @alpha (undocumented)
373
373
  export interface IConnectableRuntime {
374
374
  // (undocumented)
375
375
  readonly clientId: string | undefined;
@@ -386,7 +386,7 @@ export interface IContainerRuntimeMessageCompatDetails {
386
386
  behavior: CompatModeBehavior;
387
387
  }
388
388
 
389
- // @internal (undocumented)
389
+ // @alpha (undocumented)
390
390
  export interface IContainerRuntimeMetadata extends ICreateContainerMetadata, IGCMetadata {
391
391
  readonly disableIsolatedChannels?: true;
392
392
  readonly idCompressorEnabled?: boolean;
@@ -397,7 +397,7 @@ export interface IContainerRuntimeMetadata extends ICreateContainerMetadata, IGC
397
397
  readonly telemetryDocumentId?: string;
398
398
  }
399
399
 
400
- // @internal
400
+ // @alpha
401
401
  export interface IContainerRuntimeOptions {
402
402
  readonly chunkSizeInBytes?: number;
403
403
  readonly compressionOptions?: ICompressionRuntimeOptions;
@@ -413,19 +413,19 @@ export interface IContainerRuntimeOptions {
413
413
  readonly summaryOptions?: ISummaryRuntimeOptions;
414
414
  }
415
415
 
416
- // @internal (undocumented)
416
+ // @alpha (undocumented)
417
417
  export interface ICreateContainerMetadata {
418
418
  createContainerRuntimeVersion?: string;
419
419
  createContainerTimestamp?: number;
420
420
  }
421
421
 
422
- // @internal
422
+ // @alpha
423
423
  export interface IEnqueueSummarizeOptions extends IOnDemandSummarizeOptions {
424
424
  readonly afterSequenceNumber?: number;
425
425
  readonly override?: boolean;
426
426
  }
427
427
 
428
- // @internal (undocumented)
428
+ // @alpha (undocumented)
429
429
  export interface IGCMetadata {
430
430
  readonly gcFeature?: GCVersion;
431
431
  readonly gcFeatureMatrix?: GCFeatureMatrix;
@@ -435,7 +435,7 @@ export interface IGCMetadata {
435
435
  readonly sweepTimeoutMs?: number;
436
436
  }
437
437
 
438
- // @internal (undocumented)
438
+ // @alpha (undocumented)
439
439
  export interface IGCRuntimeOptions {
440
440
  [key: string]: any;
441
441
  disableGC?: boolean;
@@ -444,11 +444,11 @@ export interface IGCRuntimeOptions {
444
444
  sessionExpiryTimeoutMs?: number;
445
445
  }
446
446
 
447
- // @internal
447
+ // @alpha
448
448
  export interface IGCStats extends IMarkPhaseStats, ISweepPhaseStats {
449
449
  }
450
450
 
451
- // @internal
451
+ // @alpha
452
452
  export interface IGeneratedSummaryStats extends ISummaryStats {
453
453
  readonly dataStoreCount: number;
454
454
  readonly gcBlobNodeCount?: number;
@@ -458,7 +458,7 @@ export interface IGeneratedSummaryStats extends ISummaryStats {
458
458
  readonly summaryNumber: number;
459
459
  }
460
460
 
461
- // @internal
461
+ // @alpha
462
462
  export interface IGenerateSummaryTreeResult extends Omit<IBaseSummarizeResult, "stage"> {
463
463
  readonly forcedFullTree: boolean;
464
464
  readonly generateDuration: number;
@@ -468,7 +468,7 @@ export interface IGenerateSummaryTreeResult extends Omit<IBaseSummarizeResult, "
468
468
  readonly summaryTree: ISummaryTree;
469
469
  }
470
470
 
471
- // @internal
471
+ // @alpha
472
472
  export interface IMarkPhaseStats {
473
473
  attachmentBlobCount: number;
474
474
  dataStoreCount: number;
@@ -481,7 +481,7 @@ export interface IMarkPhaseStats {
481
481
  updatedNodeCount: number;
482
482
  }
483
483
 
484
- // @internal (undocumented)
484
+ // @alpha (undocumented)
485
485
  export interface INackSummaryResult extends IRetriableFailureResult {
486
486
  // (undocumented)
487
487
  readonly ackNackDuration: number;
@@ -492,12 +492,12 @@ export interface INackSummaryResult extends IRetriableFailureResult {
492
492
  // @internal
493
493
  export const InactiveResponseHeaderKey = "isInactive";
494
494
 
495
- // @internal (undocumented)
495
+ // @alpha (undocumented)
496
496
  export interface IOnDemandSummarizeOptions extends ISummarizeOptions {
497
497
  readonly reason: string;
498
498
  }
499
499
 
500
- // @internal
500
+ // @alpha
501
501
  export interface IRefreshSummaryAckOptions {
502
502
  readonly ackHandle: string;
503
503
  readonly proposalHandle: string | undefined;
@@ -505,13 +505,13 @@ export interface IRefreshSummaryAckOptions {
505
505
  readonly summaryRefSeq: number;
506
506
  }
507
507
 
508
- // @internal
508
+ // @alpha
509
509
  export interface IRetriableFailureResult {
510
510
  // (undocumented)
511
511
  readonly retryAfterSeconds?: number;
512
512
  }
513
513
 
514
- // @internal
514
+ // @alpha
515
515
  export interface ISerializedElection {
516
516
  readonly electedClientId: string | undefined;
517
517
  readonly electedParentId: string | undefined;
@@ -524,7 +524,7 @@ export function isRuntimeMessage(message: ISequencedDocumentMessage): boolean;
524
524
  // @internal
525
525
  export function isStableId(str: string): str is StableId;
526
526
 
527
- // @internal
527
+ // @alpha
528
528
  export interface ISubmitSummaryOpResult extends Omit<IUploadSummaryResult, "stage" | "error"> {
529
529
  readonly clientSequenceNumber: number;
530
530
  // (undocumented)
@@ -532,14 +532,14 @@ export interface ISubmitSummaryOpResult extends Omit<IUploadSummaryResult, "stag
532
532
  readonly submitOpDuration: number;
533
533
  }
534
534
 
535
- // @internal (undocumented)
535
+ // @alpha (undocumented)
536
536
  export interface ISubmitSummaryOptions extends ISummarizeOptions {
537
537
  readonly cancellationToken: ISummaryCancellationToken;
538
538
  readonly finalAttempt?: boolean;
539
539
  readonly summaryLogger: ITelemetryLoggerExt;
540
540
  }
541
541
 
542
- // @internal (undocumented)
542
+ // @alpha (undocumented)
543
543
  export interface ISummarizeEventProps {
544
544
  // (undocumented)
545
545
  currentAttempt: number;
@@ -551,7 +551,7 @@ export interface ISummarizeEventProps {
551
551
  result: "success" | "failure" | "canceled";
552
552
  }
553
553
 
554
- // @internal
554
+ // @alpha
555
555
  export interface ISummarizeOptions {
556
556
  readonly fullTree?: boolean;
557
557
  // @deprecated
@@ -571,26 +571,26 @@ export interface ISummarizer extends IEventProvider<ISummarizerEvents> {
571
571
  summarizeOnDemand(options: IOnDemandSummarizeOptions): ISummarizeResults;
572
572
  }
573
573
 
574
- // @internal (undocumented)
574
+ // @alpha (undocumented)
575
575
  export interface ISummarizeResults {
576
576
  readonly receivedSummaryAckOrNack: Promise<SummarizeResultPart<IAckSummaryResult, INackSummaryResult>>;
577
577
  readonly summaryOpBroadcasted: Promise<SummarizeResultPart<IBroadcastSummaryResult>>;
578
578
  readonly summarySubmitted: Promise<SummarizeResultPart<SubmitSummaryResult, SubmitSummaryFailureData>>;
579
579
  }
580
580
 
581
- // @internal (undocumented)
581
+ // @alpha (undocumented)
582
582
  export interface ISummarizerEvents extends IEvent {
583
583
  // (undocumented)
584
584
  (event: "summarize", listener: (props: ISummarizeEventProps) => void): any;
585
585
  }
586
586
 
587
- // @internal (undocumented)
587
+ // @alpha (undocumented)
588
588
  export interface ISummarizerInternalsProvider {
589
589
  refreshLatestSummaryAck(options: IRefreshSummaryAckOptions): Promise<void>;
590
590
  submitSummary(options: ISubmitSummaryOptions): Promise<SubmitSummaryResult>;
591
591
  }
592
592
 
593
- // @internal (undocumented)
593
+ // @alpha (undocumented)
594
594
  export interface ISummarizerRuntime extends IConnectableRuntime {
595
595
  // (undocumented)
596
596
  closeFn(): void;
@@ -627,7 +627,7 @@ export interface ISummary {
627
627
  waitBroadcast(): Promise<ISummaryOpMessage>;
628
628
  }
629
629
 
630
- // @internal
630
+ // @alpha
631
631
  export interface ISummaryAckMessage extends ISequencedDocumentMessage {
632
632
  // (undocumented)
633
633
  contents: ISummaryAck;
@@ -635,14 +635,14 @@ export interface ISummaryAckMessage extends ISequencedDocumentMessage {
635
635
  type: MessageType.SummaryAck;
636
636
  }
637
637
 
638
- // @internal (undocumented)
638
+ // @alpha (undocumented)
639
639
  export interface ISummaryBaseConfiguration {
640
640
  initialSummarizerDelayMs: number;
641
641
  maxAckWaitTime: number;
642
642
  maxOpsSinceLastSummary: number;
643
643
  }
644
644
 
645
- // @internal
645
+ // @alpha
646
646
  export type ISummaryCancellationToken = ICancellationToken<SummarizerStopReason>;
647
647
 
648
648
  // @internal (undocumented)
@@ -651,22 +651,22 @@ export interface ISummaryCollectionOpEvents extends IEvent {
651
651
  (event: OpActionEventName, listener: OpActionEventListener): any;
652
652
  }
653
653
 
654
- // @internal (undocumented)
654
+ // @alpha (undocumented)
655
655
  export type ISummaryConfiguration = ISummaryConfigurationDisableSummarizer | ISummaryConfigurationDisableHeuristics | ISummaryConfigurationHeuristics;
656
656
 
657
- // @internal (undocumented)
657
+ // @alpha (undocumented)
658
658
  export interface ISummaryConfigurationDisableHeuristics extends ISummaryBaseConfiguration {
659
659
  // (undocumented)
660
660
  state: "disableHeuristics";
661
661
  }
662
662
 
663
- // @internal (undocumented)
663
+ // @alpha (undocumented)
664
664
  export interface ISummaryConfigurationDisableSummarizer {
665
665
  // (undocumented)
666
666
  state: "disabled";
667
667
  }
668
668
 
669
- // @internal (undocumented)
669
+ // @alpha (undocumented)
670
670
  export interface ISummaryConfigurationHeuristics extends ISummaryBaseConfiguration {
671
671
  maxIdleTime: number;
672
672
  maxOps: number;
@@ -680,10 +680,10 @@ export interface ISummaryConfigurationHeuristics extends ISummaryBaseConfigurati
680
680
  state: "enabled";
681
681
  }
682
682
 
683
- // @internal
683
+ // @alpha
684
684
  export type ISummaryMetadataMessage = Pick<ISequencedDocumentMessage, "clientId" | "clientSequenceNumber" | "minimumSequenceNumber" | "referenceSequenceNumber" | "sequenceNumber" | "timestamp" | "type">;
685
685
 
686
- // @internal
686
+ // @alpha
687
687
  export interface ISummaryNackMessage extends ISequencedDocumentMessage {
688
688
  // (undocumented)
689
689
  contents: ISummaryNack;
@@ -691,7 +691,7 @@ export interface ISummaryNackMessage extends ISequencedDocumentMessage {
691
691
  type: MessageType.SummaryNack;
692
692
  }
693
693
 
694
- // @internal
694
+ // @alpha
695
695
  export interface ISummaryOpMessage extends ISequencedDocumentMessage {
696
696
  // (undocumented)
697
697
  contents: ISummaryContent;
@@ -699,14 +699,14 @@ export interface ISummaryOpMessage extends ISequencedDocumentMessage {
699
699
  type: MessageType.Summarize;
700
700
  }
701
701
 
702
- // @internal (undocumented)
702
+ // @alpha (undocumented)
703
703
  export interface ISummaryRuntimeOptions {
704
704
  // @deprecated
705
705
  initialSummarizerDelayMs?: number;
706
706
  summaryConfigOverrides?: ISummaryConfiguration;
707
707
  }
708
708
 
709
- // @internal
709
+ // @alpha
710
710
  export interface ISweepPhaseStats {
711
711
  deletedAttachmentBlobCount: number;
712
712
  deletedDataStoreCount: number;
@@ -716,7 +716,7 @@ export interface ISweepPhaseStats {
716
716
  lifetimeNodeCount: number;
717
717
  }
718
718
 
719
- // @internal
719
+ // @alpha
720
720
  export interface IUploadSummaryResult extends Omit<IGenerateSummaryTreeResult, "stage"> {
721
721
  readonly handle: string;
722
722
  // (undocumented)
@@ -762,13 +762,13 @@ export enum RuntimeMessage {
762
762
  Rejoin = "rejoin"
763
763
  }
764
764
 
765
- // @internal
765
+ // @alpha
766
766
  export interface SubmitSummaryFailureData extends IRetriableFailureResult {
767
767
  // (undocumented)
768
768
  stage: SummaryStage;
769
769
  }
770
770
 
771
- // @internal
771
+ // @alpha
772
772
  export type SubmitSummaryResult = IBaseSummarizeResult | IGenerateSummaryTreeResult | IUploadSummaryResult | ISubmitSummaryOpResult;
773
773
 
774
774
  // @internal
@@ -797,7 +797,7 @@ export class Summarizer extends TypedEventEmitter<ISummarizerEvents> implements
797
797
  readonly summaryCollection: SummaryCollection;
798
798
  }
799
799
 
800
- // @internal (undocumented)
800
+ // @alpha (undocumented)
801
801
  export type SummarizeResultPart<TSuccess, TFailure = undefined> = {
802
802
  success: true;
803
803
  data: TSuccess;
@@ -808,7 +808,7 @@ export type SummarizeResultPart<TSuccess, TFailure = undefined> = {
808
808
  error: any;
809
809
  };
810
810
 
811
- // @internal (undocumented)
811
+ // @alpha (undocumented)
812
812
  export type SummarizerStopReason =
813
813
  /** Summarizer client failed to summarize in all 3 consecutive attempts. */
814
814
  "failToSummarize"
@@ -859,7 +859,7 @@ export class SummaryCollection extends TypedEventEmitter<ISummaryCollectionOpEve
859
859
  waitSummaryAck(referenceSequenceNumber: number): Promise<IAckedSummary>;
860
860
  }
861
861
 
862
- // @internal
862
+ // @alpha
863
863
  export type SummaryStage = SubmitSummaryResult["stage"] | "unknown";
864
864
 
865
865
  // @internal
@@ -31,7 +31,7 @@ export declare class BlobHandle implements IFluidHandle<ArrayBufferLike> {
31
31
  }
32
32
  /**
33
33
  * Information from a snapshot needed to load BlobManager
34
- * @internal
34
+ * @alpha
35
35
  */
36
36
  export interface IBlobManagerLoadInfo {
37
37
  ids?: string[];