GA core-lro v3

[MaryGao]

The preview pr is merged here: #29311.

GA core-lro v3:

• api view: diff compared with v3
• migration guide: here
• design doc: gist, loop 1, loop 2

Impacted SDKs:

• Currently I think no SDKs would be impacted.

  • Existing HLC SDKs would use v2, no impact;
  • RLC LRO wrapped its interface with v3 and without any breakings(see pr detail), no impact;
  • Modular would use v3. The only modular SDK that is OpenAI without LRO operations, so no impact.

• In future there would be breaking when migrating HLC to Modular.

Main changes:

- export function createHttpPoller<TResult, TState extends OperationState<TResult>>(lro: LongRunningOperation, options?: CreateHttpPollerOptions<TResult, TState>): Promise<SimplePollerLike<TState, TResult>>;
+ export function createHttpPoller<TResult, TState extends OperationState<TResult>>(lro: RunningOperation, options?: CreateHttpPollerOptions<TResult, TState>): PollerLike<TState, TResult>;

- export interface SimplePollerLike<TState extends OperationState<TResult>, TResult> {
+ export interface PollerLike<TState extends OperationState<TResult>, TResult> extends Promise<TResult> {
-    getOperationState(): TState;
+    readonly operationState: TState | undefined;
-    getResult(): TResult | undefined;
+    readonly result: TResult | undefined;
-    isDone(): boolean;
+    readonly isDone: boolean;
-    isStopped(): boolean;
-    stopPolling(): void;
-    toString(): string;
+    serialize(): Promise<string>;
+    submitted(): Promise<void>;
    onProgress(callback: (state: TState) => void): CancelOnProgress;
    poll(options?: {
        abortSignal?: AbortSignalLike;
-     }): Promise<void>;
+     }): Promise<TState>;
    pollUntilDone(pollOptions?: {
        abortSignal?: AbortSignalLike;
    }): Promise<TResult>;   
}

[MaryGao]

/azp run js - core - ci

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[azure-sdk]

API change check

API changes are not detected in this pull request.

[MaryGao]

Offline confirmed we will merge the implementation pr and go to offline review on API View with JS archs.