ci: support update dependencies (#1098)

* ci: support update dependencies

* [AUTO] Generate codes by terra (#1100)

Co-authored-by: LichKing-2234 <[email protected]>

---------

Co-authored-by: sda-rob <[email protected]>
Co-authored-by: LichKing-2234 <[email protected]>

Author: LichKing-2234

.github/actions/doc/action.yml

@@ -1,25 +1,31 @@
 name: Doc
-description: Generate comments
+description: Generate comments.
 
 inputs:
-  target-path:
-    description: The path to generate comments, if set, will skip clone & pr
-    default: ""
   github-token:
-    description: The github token
+    description: >
+      GITHUB_TOKEN (permissions contents: write and pull-requests: write) or a repo scoped Personal Access Token (PAT).
     required: true
 
+  target-repo:
+    description: Relative path under GITHUB_WORKSPACE to the repository.
+
+  target-branch:
+    description: Sets the pull request base branch.
+
 runs:
   using: composite
   steps:
     - name: Generate comments
       uses: AgoraIO-Extensions/actions/.github/actions/doc@main
       with:
-        target-repo: ${{ github.repository }}
-        target-branch: ${{ github.ref_name }}
-        target-path: ${{ inputs.target-path }}
+        github-token: ${{ inputs.github-token }}
+        target-repo: ${{ inputs.target-repo }}
+        target-branch: ${{ inputs.target-branch }}
         config: fmt_config/fmt_ts.yaml
         language: ts
         base-template-url: https://github.com/AgoraIO/agora_doc_source/releases/download/master-build/electron_ng_json_template_en.json
         export-file-path: ts/AgoraSdk.ts
-        github-token: ${{ inputs.github-token }}
+        pre-pr-command: |
+          rm -rf iris-doc
+          yarn lint --fix

.github/workflows/dep.yml

@@ -0,0 +1,29 @@
+name: Update dependencies
+
+on:
+  workflow_dispatch:
+    inputs:
+      dependencies-content:
+        description: The content of dependencies
+        required: true
+        type: string
+
+jobs:
+  update-dependencies:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup
+        uses: ./.github/actions/setup
+
+      - name: Update dependencies
+        id: dep
+        uses: AgoraIO-Extensions/actions/.github/actions/dep@main
+        with:
+          github-token: ${{ secrets.GH_TOKEN }}
+          target-branch: ${{ github.ref_name }}
+          dependencies-content: ${{ inputs.dependencies-content }}          
+          target-files: |
+            package.json

.github/workflows/doc.yml

@@ -9,8 +9,12 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v3
-    
+
+      - name: Setup
+        uses: ./.github/actions/setup
+
       - name: Generate comments
         uses: ./.github/actions/doc
         with:
           github-token: ${{ secrets.GH_TOKEN }}
+          target-branch: ${{ github.ref_name }}

.github/workflows/terra.yml

@@ -19,17 +19,17 @@ jobs:
         uses: ./.github/actions/setup
 
       - name: Generate codes
+        id: terra
         uses: AgoraIO-Extensions/actions/.github/actions/terra@main
         env:
           LLVM_DOWNLOAD_URL: |
             https://github.com/llvm/llvm-project/releases/download/llvmorg-15.0.6/clang+llvm-15.0.6-x86_64-linux-gnu-ubuntu-18.04.tar.xz
         with:
+          github-token: ${{ secrets.GH_TOKEN }}
           terra-ref: ${{ inputs.terra-ref }}
-          target-path: ${{ github.workspace }}
           config: ci/config/terra_config.yaml
           output-dir: ts/Private
           export-file-path: ts/AgoraSdk.ts
-          github-token: ${{ secrets.GH_TOKEN }}
 
       - name: Format codes
         run: |
@@ -43,17 +43,20 @@ jobs:
       - name: Generate comments
         uses: ./.github/actions/doc
         with:
-          target-path: ${{ github.workspace }}
           github-token: ${{ secrets.GH_TOKEN }}
+          target-path: ${{ github.workspace }}
 
       - name: Create pull request
         uses: AgoraIO-Extensions/actions/.github/actions/pr@main
         with:
+          github-token: ${{ secrets.GH_TOKEN }}
           target-repo: ${{ github.workspace }}
           target-branch: ${{ github.ref_name }}
-          target-branch-name-surffix: |
-            terra-update
+          target-branch-name-surffix: terra-update
           pull-request-title: |
-            [AUTO] Generate code by terra
+            [AUTO] Generate codes by terra
+          pull-request-body: |
+            Terra configuration:
+
+            ${{ steps.terra.outputs.configuration }}
           add-paths: ts
-          github-token: ${{ secrets.GH_TOKEN }}

ts/Private/AgoraBase.ts

@@ -1365,7 +1365,7 @@ export class VideoEncoderConfiguration {
  */
 export class DataStreamConfig {
   /**
-   * Whether to synchronize the data packet with the published audio packet. true : Synchronize the data packet with the audio packet. false : Do not synchronize the data packet with the audio packet. When you set the data packet to synchronize with the audio, then if the data packet delay is within the audio delay, the SDK triggers the onStreamMessage callback when the synchronized audio packet is played out. Do not set this parameter as true if you need the receiver to receive the data packet immediately. Agora recommends that you set this parameter to true only when you need to implement specific functions, for example, lyric synchronization.
+   * Whether to synchronize the data packet with the published audio packet. true : Synchronize the data packet with the audio packet. This setting is suitable for special scenarios such as lyrics synchronization. false : Do not synchronize the data packet with the audio packet. This setting is suitable for scenarios where data packets need to arrive at the receiving end immediately. When you set the data packet to synchronize with the audio, then if the data packet delay is within the audio delay, the SDK triggers the onStreamMessage callback when the synchronized audio packet is played out.
    */
   syncWithAudio?: boolean;
   /**

ts/Private/IAgoraMediaPlayer.ts

@@ -23,7 +23,7 @@ export abstract class IMediaPlayer {
    * Gets the ID of the media player.
    *
    * @returns
-   * ≥ 0: Success. The ID of the media player.
+   * Success. The ID of the media player.
    *  < 0: Failure.
    */
   abstract getMediaPlayerId(): number;

ts/Private/IAgoraRtcEngine.ts

@@ -374,7 +374,7 @@ export enum PriorityType {
  */
 export class LocalVideoStats {
   /**
-   * The user ID of the local user.
+   * The ID of the local user.
    */
   uid?: number;
   /**
@@ -1402,7 +1402,7 @@ export interface IRtcEngineEventHandler {
   /**
    * Occurs when the playback of the local music file finishes.
    *
-   * Deprecated: Please use onAudioMixingStateChanged instead. After you call startAudioMixing to play a local music file, this callback occurs when the playback finishes. If the call startAudioMixing fails, the error code WARN_AUDIO_MIXING_OPEN_ERROR is returned.
+   * Deprecated: Use onAudioMixingStateChanged instead. After you call startAudioMixing to play a local music file, this callback occurs when the playback finishes. If the call of startAudioMixing fails, the error code WARN_AUDIO_MIXING_OPEN_ERROR is returned.
    */
   onAudioMixingFinished?(): void;
 
@@ -1411,7 +1411,7 @@ export interface IRtcEngineEventHandler {
    *
    * This callback occurs when the local audio effect file finishes playing.
    *
-   * @param soundId The audio effect ID. The ID of each audio effect file is unique.
+   * @param soundId The ID of the audio effect. The ID of each audio effect file is unique.
    */
   onAudioEffectFinished?(soundId: number): void;
 
@@ -1753,7 +1753,7 @@ export interface IRtcEngineEventHandler {
   /**
    * Occurs when the camera turns on and is ready to capture the video.
    *
-   * Deprecated: Please use LocalVideoStreamStateCapturing (1) in onLocalVideoStateChanged instead. This callback indicates that the camera has been successfully turned on and you can start to capture video.
+   * Deprecated: Use LocalVideoStreamStateCapturing (1) in onLocalVideoStateChanged instead. This callback indicates that the camera has been successfully turned on and you can start to capture video.
    */
   onCameraReady?(): void;
 
@@ -2328,9 +2328,9 @@ export interface IRtcEngineEventHandler {
    * Occurs when the video subscribing state changes.
    *
    * @param channel The channel name.
-   * @param uid The ID of the remote user.
-   * @param oldState The previous subscribing status, see StreamSubscribeState for details.
-   * @param newState The current subscribing status, see StreamSubscribeState for details.
+   * @param uid The user ID of the remote user.
+   * @param oldState The previous subscribing status. See StreamSubscribeState.
+   * @param newState The current subscribing status. See StreamSubscribeState.
    * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state.
    */
   onVideoSubscribeStateChanged?(
@@ -2640,16 +2640,16 @@ export enum MaxMetadataSizeType {
 export class Metadata {
   /**
    * The user ID.
-   *  For the recipient:the ID of the remote user who sent the Metadata.
-   *  Ignore it for sender.
+   *  For the recipient: The ID of the remote user who sent the Metadata.
+   *  For the sender: Ignore it.
    */
   uid?: number;
   /**
-   * Buffer size for received or sent Metadata.
+   * The buffer size of the sent or received Metadata.
    */
   size?: number;
   /**
-   * The buffer address of the received or sent Metadata.
+   * The buffer address of the sent or received Metadata.
    */
   buffer?: Uint8Array;
   /**
@@ -3140,28 +3140,7 @@ export abstract class IRtcEngine {
   abstract stopEchoTest(): number;
 
   /**
-   * Enables or disables multi-camera capture.
-   *
-   * In scenarios where there are existing cameras to capture video, Agora recommends that you use the following steps to capture and publish video with multiple cameras:
-   *  Call this method to enable multi-channel camera capture.
-   *  Call startPreview to start the local video preview.
-   *  Call startCameraCapture, and set sourceType to start video capture with the second camera.
-   *  Call joinChannelEx, and set publishSecondaryCameraTrack to true to publish the video stream captured by the second camera in the channel. If you want to disable multi-channel camera capture, use the following steps:
-   *  Call stopCameraCapture.
-   *  Call this method with enabled set to false. You can call this method before and after startPreview to enable multi-camera capture:
-   *  If it is enabled before startPreview, the local video preview shows the image captured by the two cameras at the same time.
-   *  If it is enabled after startPreview, the SDK stops the current camera capture first, and then enables the primary camera and the second camera. The local video preview appears black for a short time, and then automatically returns to normal. When using this function, ensure that the system version is 13.0 or later. The minimum iOS device types that support multi-camera capture are as follows:
-   *  iPhone XR
-   *  iPhone XS
-   *  iPhone XS Max
-   *  iPad Pro 3rd generation and later
-   *
-   * @param enabled Whether to enable multi-camera video capture mode: true : Enable multi-camera capture mode; the SDK uses multiple cameras to capture video. false : Disable multi-camera capture mode; the SDK uses a single camera to capture video.
-   * @param config Capture configuration for the second camera. See CameraCapturerConfiguration.
-   *
-   * @returns
-   * 0: Success.
-   *  < 0: Failure.
+   * @ignore
    */
   abstract enableMultiCamera(
     enabled: boolean,
@@ -4328,7 +4307,7 @@ export abstract class IRtcEngine {
   /**
    * Retrieves the playback position of the audio effect file.
    *
-   * Call this method after the playEffect method.
+   * Call this method after playEffect.
    *
    * @param soundId The audio effect ID. The ID of each audio effect file is unique.
    *
@@ -5586,6 +5565,8 @@ export abstract class IRtcEngine {
   /**
    * Stops screen capture.
    *
+   * After calling startScreenCaptureByWindowId or startScreenCaptureByDisplayId to start screen capture, call this method to stop screen capture.
+   *
    * @returns
    * 0: Success.
    *  < 0: Failure.
@@ -6680,7 +6661,7 @@ export abstract class IRtcEngine {
    *
    * If the metadata is sent successfully, the SDK triggers the onMetadataReceived callback on the receiver.
    *
-   * @param metadata Media metadata See Metadata.
+   * @param metadata Media metadata. See Metadata.
    * @param sourceType The type of the video source. See VideoSourceType.
    *
    * @returns