Add workflows to release, version, and list Connect extensions

.github/actions/lint-extension/action.yml

@@ -0,0 +1,38 @@
+name: Lint Extension
+description: Lint an extension for release
+
+inputs:
+  extension-name:
+    description: The name of the extension
+    required: true
+    type: string
+
+runs:
+  using: "composite"
+
+  steps:
+    # Ensures that the manifest.json for the given extension name
+    # contains all the required fields for the rest of the release workflow
+    - run: |
+        jq '
+          if (.extension | type) != "object" then error("Missing extension object")
+          elif (.extension.name | type) != "string" then error("Missing extension.name")
+          elif (.extension.title | type) != "string" then error("Missing extension.title")
+          elif (.extension.description | type) != "string" then error("Missing extension.description")
+          elif (.extension.homepage | type) != "string" then error("Missing extension.homepage")
+          elif (.extension.version | type) != "string" then error("Missing extension.version")
+          else . end
+        ' ./extensions/${{ inputs.extension-name }}/manifest.json
+      shell: bash
+
+    - uses: actions/setup-node@v4
+
+    - run: npm install -g semver
+      shell: bash
+
+    # The semver must be valid for the sorting, comparisons, and release
+    # process to work
+    - name: Check for valid semver
+      run: |
+        semver -c $(jq -c -r '.extension.version' < ./extensions/${{ inputs.extension-name }}/manifest.json)
+      shell: bash

.github/actions/package-extension/action.yml

@@ -0,0 +1,45 @@
+name: Package Extension
+description: Package an extension into a tarball for release
+
+inputs:
+  extension-name:
+    description: The name of the extension
+    required: true
+    type: string
+  artifact-name:
+    description: The name of the artifact
+    required: false
+    type: string
+
+runs:
+  using: "composite"
+
+  steps:
+    # If we are not passed an artifact to use as the source for the tarball
+    # we will create a tarball from the extension's directory
+    - name: Create tar
+      if: ${{ inputs.artifact-name == '' }}
+      run: tar -czf ${{ inputs.extension-name}}.tar.gz ./extensions/${{ inputs.extension-name}}
+      shell: bash
+
+    # If we are passed an artifact to use as the source for the tarball
+    # we will download the artifact and create a tarball from it
+    # this avoids including extra files in the extension
+    - name: Download optional artifact
+      if: ${{ inputs.artifact-name != '' }}
+      uses: actions/download-artifact@v4
+      with:
+        name: ${{ inputs.artifact-name }}
+        path: ${{ inputs.extension-name }}
+
+    - name: Create tar from artifact
+      if: ${{ inputs.artifact-name != '' }}
+      run: tar -czf ${{ inputs.extension-name }}.tar.gz ${{ inputs.extension-name }}
+      shell: bash
+
+    # Upload the extension's tarball for use in other actions in the workflow
+    - name: Upload extension tar
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ inputs.extension-name }}.tar.gz
+        path: ${{ inputs.extension-name }}.tar.gz

.github/actions/release-extension/action.yml

@@ -0,0 +1,94 @@
+name: Release Extension
+description: Release an extension as a GitHub Release
+
+inputs:
+  extension-name:
+    description: The name of the extension
+    required: true
+    type: string
+
+runs:
+  using: "composite"
+
+  steps:
+    - uses: actions/setup-node@v4
+
+    - run: npm install -g semver
+      shell: bash
+
+    - name: Get manifest extension version
+      run: |
+        MANIFEST_VERSION=$(semver -c $(jq -c -r '.extension.version' < ./extensions/${{ inputs.extension-name }}/manifest.json))
+        echo "MANIFEST_VERSION=$MANIFEST_VERSION" >> "$GITHUB_ENV"
+      shell: bash
+
+    # Grabs the latest version from the extensions.json file
+    # If an extension hasn't been released yet we default to `0.0.0` so any
+    # version in the manifest will be higher
+    - name: Get lastest version from extension list
+      continue-on-error: true
+      run: |
+        LATEST_VERSION=$(jq -c '.extensions[] | select(.name=="${{ inputs.extension-name }}").latestVersion.version' < extensions.json)
+        LATEST_VERSION=$(semver -c "${LATEST_VERSION:-0.0.0}")
+        echo "LATEST_VERSION=$LATEST_VERSION" >> "$GITHUB_ENV"
+      shell: bash
+
+    # We only want to release if the manifest.json contains a newer semver
+    # version than the latest version in the extensions.json
+    # We compare that here, and echo if a release will occur
+    # This can be helpful when looking at Pull Request action outputs
+    # so it is clear what will happen on a merge to `main`
+    - name: Check if manifest has newer version
+      id: should_release
+      run: |
+        echo "The manifest version is '$MANIFEST_VERSION' and the released version is '$LATEST_VERSION'"
+        HIGHER_VERSION=$(semver "$MANIFEST_VERSION" "$LATEST_VERSION" | tail -n 1)
+          if [ "$MANIFEST_VERSION" = "$HIGHER_VERSION" ] && [ "$MANIFEST_VERSION" != "$LATEST_VERSION" ]; then
+          echo "🚀 Will release! The manifest version is greater than the released version."
+          echo "should_release=true" >> "$GITHUB_OUTPUT"
+        else
+          echo "😴 Holding back from release: The manifest version is not greater than the released version."
+          echo "should_release=false" >> "$GITHUB_OUTPUT"
+        fi
+      shell: bash
+
+    # Here we download the packaged extension artifact to release
+    - uses: actions/download-artifact@v4
+      if: github.ref_name == 'main' && steps.should_release.outputs.should_release == 'true'
+      with:
+        name: ${{ inputs.extension-name }}.tar.gz
+
+    # The release tag utilizes both the extension name and semver version
+    # to create a unique tag for the repository
+    - name: Release tag
+      if: github.ref_name == 'main' && steps.should_release.outputs.should_release == 'true'
+      id: release_tag
+      run: |
+        RELEASE_TAG="${{ inputs.extension-name }}@v$MANIFEST_VERSION"
+        echo "RELEASE_TAG=$RELEASE_TAG" >> "$GITHUB_ENV"
+      shell: bash
+
+    - name: Release
+      if: github.ref_name == 'main' && steps.should_release.outputs.should_release == 'true'
+      run: |
+        gh release create $RELEASE_TAG \
+          --title "${{ inputs.extension-name }} v$MANIFEST_VERSION" \
+          ${{ inputs.extension-name }}.tar.gz
+      shell: bash
+
+    # We fetch the GitHub release using the GitHub API, storing the data 
+    # for use in the extension list update.
+    - name: Get release data
+      if: github.ref_name == 'main' && steps.should_release.outputs.should_release == 'true'
+      run: gh api /repos/${{ github.repository }}/releases/tags/$RELEASE_TAG > release-${{ inputs.extension-name }}.json
+      shell: bash
+
+    # Each release data file is uploaded as an artifact for the extension list update
+    # The naming convention is `release-<extension-name>.json` to easily
+    # download each artifact matching the pattern
+    - name: Upload release data
+      if: github.ref_name == 'main' && steps.should_release.outputs.should_release == 'true'
+      uses: actions/upload-artifact@v4
+      with:
+        name: release-${{ inputs.extension-name }}.json
+        path: release-${{ inputs.extension-name }}.json