action.yml

name: "Update Manifest and Commit Changes"
description: "Checks out the repository, sets up Node, installs dependencies, updates manifest.json, formats, and commits/pushes changes signing the commit."
inputs:
  action:
    description: "Action to perform: publish or delete the artifact branch."
    required: false
    default: "publish"
  manifestPath:
    description: "The path to the manifest.json file."
    required: false
    default: "${{ github.workspace }}/manifest.json"
  schemaPath:
    description: "The path to the plugin settings schema."
    required: false
    default: "${{ github.workspace }}/src/types/plugin-input.ts"
  pluginEntry:
    description: "The path to the plugin entry file."
    required: false
    default: "${{ github.workspace }}/src/index.ts"
  commitMessage:
    description: "The commit message."
    required: false
    default: "chore: [skip ci] updated manifest.json and dist build"
  sourceRef:
    description: "Source branch ref used for short_name and artifact branch mapping."
    required: false
    default: "${{ github.event_name == 'delete' && github.event.ref || github.event.workflow_run.head_branch || github.ref_name }}"
  artifactPrefix:
    description: "Prefix used for artifact branches."
    required: false
    default: "dist/"
  nodeVersion:
    description: "The version of Node.js to use."
    default: "24.11.0"
  treatAsEsm:
    description: "If the package is set to be treated as ESM, it will replace __dirname occurrences."
    default: "false"
  bundleSingleFile:
    description: "Bundle plugin entry into a single file (disables code splitting)."
    default: "false"
  sourcemap:
    description: "Generates the sourcemap for the compiled files"
    required: false
    default: "false"
  skipBotEvents:
    description: "Sets manifest.skipBotEvents (true/false)."
    required: false
    default: "true"
  excludeSupportedEvents:
    description: "Comma-separated supported events to remove from generated manifest listeners."
    required: false
    default: ""
outputs: {}
runs:
  using: "composite"
  steps:
    - name: Validate action input
      shell: bash
      run: |
        if [[ "${{ inputs.action }}" != "publish" && "${{ inputs.action }}" != "delete" ]]; then
          echo "::error::Invalid action '${{ inputs.action }}'. Must be 'publish' or 'delete'."
          exit 1
        fi

    - name: Resolve source and artifact refs
      id: resolve_refs
      shell: bash
      env:
        SOURCE_REF_INPUT: ${{ inputs.sourceRef }}
        ARTIFACT_PREFIX_INPUT: ${{ inputs.artifactPrefix }}
        EVENT_REF_TYPE: ${{ github.event.ref_type || '' }}
      run: |
        source_ref="$SOURCE_REF_INPUT"
        source_ref="${source_ref#refs/heads/}"
        source_ref="${source_ref#refs/tags/}"
        if [ -z "$source_ref" ]; then
          source_ref="${GITHUB_REF_NAME}"
        fi

        artifact_prefix="$ARTIFACT_PREFIX_INPUT"
        if [ -z "$artifact_prefix" ]; then
          artifact_prefix="dist/"
        fi
        artifact_prefix="${artifact_prefix#refs/heads/}"
        if [[ "$artifact_prefix" != */ ]]; then
          artifact_prefix="${artifact_prefix}/"
        fi

        is_tag_ref="false"
        if [[ "$EVENT_REF_TYPE" == "tag" ]] || [[ "${GITHUB_REF:-}" == refs/tags/* ]]; then
          is_tag_ref="true"
        fi

        is_artifact_ref="false"
        if [[ "$source_ref" == "$artifact_prefix"* ]]; then
          is_artifact_ref="true"
        fi

        should_skip="false"
        skip_reason=""
        if [[ "$is_tag_ref" == "true" ]]; then
          should_skip="true"
          skip_reason="tag refs are not supported"
        elif [[ "$is_artifact_ref" == "true" ]]; then
          should_skip="true"
          skip_reason="artifact refs are ignored"
        fi

        echo "source_ref=$source_ref" >> "$GITHUB_OUTPUT"
        echo "artifact_prefix=$artifact_prefix" >> "$GITHUB_OUTPUT"
        echo "is_tag_ref=$is_tag_ref" >> "$GITHUB_OUTPUT"
        echo "is_artifact_ref=$is_artifact_ref" >> "$GITHUB_OUTPUT"
        echo "should_skip=$should_skip" >> "$GITHUB_OUTPUT"
        echo "skip_reason=$skip_reason" >> "$GITHUB_OUTPUT"
        echo "SOURCE_REF=$source_ref" >> "$GITHUB_ENV"
        echo "ARTIFACT_PREFIX=$artifact_prefix" >> "$GITHUB_ENV"

    - name: Skip unsupported refs
      if: ${{ steps.resolve_refs.outputs.should_skip == 'true' }}
      shell: bash
      env:
        SOURCE_REF: ${{ steps.resolve_refs.outputs.source_ref }}
        SKIP_REASON: ${{ steps.resolve_refs.outputs.skip_reason }}
      run: |
        echo "::notice::Skipping action for '${SOURCE_REF}' (${SKIP_REASON})."

    - name: Check out the repository
      if: ${{ inputs.action == 'publish' && steps.resolve_refs.outputs.should_skip != 'true' }}
      uses: actions/checkout@v6
      with:
        ref: ${{ steps.resolve_refs.outputs.source_ref }}

    - name: Set up Node.js
      if: ${{ steps.resolve_refs.outputs.should_skip != 'true' }}
      uses: actions/setup-node@v6
      with:
        node-version: ${{ inputs.nodeVersion }}

    - name: Set up Deno
      if: ${{ steps.resolve_refs.outputs.should_skip != 'true' }}
      uses: denoland/setup-deno@v2
      with:
        deno-version: v2.x

    - uses: oven-sh/setup-bun@v2
      if: ${{ steps.resolve_refs.outputs.should_skip != 'true' }}

    - name: Install dependencies
      if: ${{ inputs.action == 'publish' && steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      run: |
        # Keep project install-time generators (if any) available for builds.
        bun install --frozen-lockfile

    - name: Prepare manifest configuration JSON
      if: ${{ inputs.action == 'publish' && steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      env:
        MANIFEST_PATH: ${{ inputs.manifestPath }}
        SKIP_BOT_EVENTS: ${{ inputs.skipBotEvents }}
        EXCLUDE_SUPPORTED_EVENTS: ${{ inputs.excludeSupportedEvents }}
        GITHUB_WORKSPACE: ${{ github.workspace }}
        GITHUB_REPOSITORY: ${{ github.repository }}
        GITHUB_REF_NAME: ${{ steps.resolve_refs.outputs.source_ref }}
      run: |
        echo "Resolved SKIP_BOT_EVENTS=${SKIP_BOT_EVENTS}"
        node ${{ github.action_path }}/.github/scripts/update-manifest.js

    - name: Build project
      if: ${{ inputs.action == 'publish' && steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      run: |
        echo "Deleting previous dist..."
        rm -rf "${{ github.workspace }}/dist"
        if [ "${{ inputs.bundleSingleFile }}" = "true" ]; then
          echo "Compiling plugin (single file)..."
          bun x esbuild ${{ inputs.pluginEntry }} --bundle --platform=node --format=esm --target=node20 --minify ${{ inputs.sourcemap == 'true' && '--sourcemap' || '' }} --external:./tests --outfile=dist/plugin/index.js
          echo "Compiling plugin types (single file)..."
          bun x esbuild ${{ inputs.schemaPath }} --bundle --platform=node --format=esm --target=node20 --minify --outfile=plugin/index.js
        else
          echo "Compiling plugin..."
          bun x @vercel/ncc build ${{ inputs.pluginEntry }} --external "./tests" -m ${{ inputs.sourcemap == 'true' && '-s' || '' }} -o dist/plugin
          echo "Compiling plugin types..."
          bun x @vercel/ncc build ${{ inputs.schemaPath }} --external "./tests" -m -o plugin
        fi

    - name: Replace __dirname with import.meta.dirname
      if: ${{ inputs.action == 'publish' && inputs.treatAsEsm && steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      run: |
        if [ "${{ inputs.treatAsEsm }}" = "true" ]; then
          sed -i 's/__dirname/import.meta.dirname/g' "${{ github.workspace }}/dist/plugin/index.js"
        fi

    - name: Finalize manifest configuration JSON
      if: ${{ inputs.action == 'publish' && steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      env:
        MANIFEST_PATH: ${{ inputs.manifestPath }}
        SKIP_BOT_EVENTS: ${{ inputs.skipBotEvents }}
        EXCLUDE_SUPPORTED_EVENTS: ${{ inputs.excludeSupportedEvents }}
        GITHUB_WORKSPACE: ${{ github.workspace }}
        GITHUB_REPOSITORY: ${{ github.repository }}
        GITHUB_REF_NAME: ${{ steps.resolve_refs.outputs.source_ref }}
      run: |
        node ${{ github.action_path }}/.github/scripts/update-manifest.js

    - name: Get GitHub App token
      if: env.APP_ID != '' && env.APP_PRIVATE_KEY != '' && steps.resolve_refs.outputs.should_skip != 'true'
      uses: actions/create-github-app-token@v1
      id: get_installation_token
      with:
        app-id: ${{ env.APP_ID }}
        private-key: ${{ env.APP_PRIVATE_KEY }}

    - name: Install push script dependencies
      if: ${{ steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      run: |
        echo "Installing dependencies for the push script in ${{ github.action_path }}"
        cd ${{ github.action_path }}
        bun install

    - name: Inject reassembly entrypoints
      if: ${{ inputs.action == 'publish' && steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      env:
        TREAT_AS_ESM: ${{ inputs.treatAsEsm }}
      run: |
        if [[ "${TREAT_AS_ESM}" == "true" ]]; then
          if [ ! -f dist/plugin/package.json ]; then
            printf '{"type":"module"}\n' > dist/plugin/package.json
          fi
          cp "${{ github.action_path }}/.github/scripts/reassembly-esm.js" dist/index.js
          printf '%s\n' \
            'import("./index.js").catch((error) => {' \
            '  console.error("Failed to load dist/index.js from CJS bridge:", error);' \
            '  process.exit(1);' \
            '});' > dist/index.cjs
          cp dist/plugin/package.json dist/package.json
        else
          cp "${{ github.action_path }}/.github/scripts/reassembly-cjs.js" dist/index.js
          cp "${{ github.action_path }}/.github/scripts/reassembly-cjs.js" dist/index.cjs
        fi

    - name: Publish manifest.json and dist to artifact branch
      if: ${{ inputs.action == 'publish' && steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      env:
        GITHUB_TOKEN: ${{ steps.get_installation_token.outputs.token || github.token }}
        GITHUB_WORKSPACE: ${{ github.workspace }}
        COMMIT_MESSAGE: ${{ inputs.commitMessage }}
        MANIFEST_PATH: ${{ inputs.manifestPath }}
        SOURCE_REF: ${{ steps.resolve_refs.outputs.source_ref }}
        ARTIFACT_PREFIX: ${{ steps.resolve_refs.outputs.artifact_prefix }}
      run: |
        # Enforce final manifest values after all build-time lifecycle scripts.
        echo "Re-applying manifest before publish with SKIP_BOT_EVENTS=${{ inputs.skipBotEvents }}"
        SKIP_BOT_EVENTS="${{ inputs.skipBotEvents }}" \
        EXCLUDE_SUPPORTED_EVENTS="${{ inputs.excludeSupportedEvents }}" \
        GITHUB_WORKSPACE="${{ github.workspace }}" \
        GITHUB_REPOSITORY="${{ github.repository }}" \
        GITHUB_REF_NAME="${{ steps.resolve_refs.outputs.source_ref }}" \
        node ${{ github.action_path }}/.github/scripts/update-manifest.js
        bun ${{ github.action_path }}/.github/scripts/push-changes.js

    - name: Delete artifact branch
      if: ${{ inputs.action == 'delete' && steps.resolve_refs.outputs.should_skip != 'true' }}
      shell: bash
      env:
        GITHUB_TOKEN: ${{ steps.get_installation_token.outputs.token || github.token }}
        SOURCE_REF: ${{ steps.resolve_refs.outputs.source_ref }}
        ARTIFACT_PREFIX: ${{ steps.resolve_refs.outputs.artifact_prefix }}
      run: |
        bun ${{ github.action_path }}/.github/scripts/delete-artifact-branch.js