httpcat-cli 0.0.17 → 0.0.20

package/.github/dependabot.yml

@@ -0,0 +1,27 @@
+version: 2
+updates:
+  # Enable version updates for npm
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "automated"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "github-actions"
+      - "automated"
+    commit-message:
+      prefix: "ci"
+      include: "scope"
+

package/.github/workflows/README.md

@@ -0,0 +1,49 @@
+# GitHub Actions Workflows
+
+This directory contains automated workflows for CI/CD and releases.
+
+## Workflows
+
+### `ci.yml`
+Continuous Integration workflow that runs on every push and pull request:
+- Runs tests across multiple Node.js versions (18, 20, 22)
+- Type checking and linting
+- Security audits
+- Code coverage reporting
+
+### `release.yml`
+Automated release workflow that:
+- Triggers on version tags (v*.*.*) or manual dispatch
+- Validates version format
+- Runs tests and builds
+- Publishes to npm
+- Updates Homebrew formula
+- Creates GitHub release with auto-generated release notes
+
+### `homebrew-tap.yml`
+Manual workflow to update the Homebrew formula in the tap repository.
+
+## Secrets Required
+
+Configure these in Repository Settings → Secrets and variables → Actions:
+
+- `NPM_TOKEN`: npm authentication token with publish permissions
+  - Generate at: https://www.npmjs.com/settings/YOUR_USERNAME/tokens
+  - Required scopes: `read:packages`, `write:packages`
+
+## Usage
+
+### Creating a Release
+
+1. **Automatic (recommended)**: Push a version tag
+   ```bash
+   git tag v1.2.3
+   git push origin v1.2.3
+   ```
+
+2. **Manual**: Use GitHub Actions UI
+   - Go to Actions → Release → Run workflow
+   - Enter version number
+   - Click Run workflow
+
+See [RELEASE.md](../RELEASE.md) for detailed release instructions.

package/.github/workflows/ci.yml

@@ -0,0 +1,101 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+env:
+  NODE_VERSION: '20'
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: ['18', '20', '22']
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Run tests
+        run: yarn test
+
+      - name: Build
+        run: yarn build
+
+      - name: Upload coverage reports
+        if: matrix.node-version == '20'
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage/lcov.info
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false
+
+  lint:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Type check
+        run: yarn build --noEmit || npx tsc --noEmit
+
+      - name: Check formatting (if configured)
+        continue-on-error: true
+        run: |
+          if [ -f ".prettierrc" ] || [ -f ".prettierrc.js" ] || [ -f ".prettierrc.json" ]; then
+            npx prettier --check "**/*.{ts,js,json,md}" || true
+          else
+            echo "No formatter configured, skipping..."
+          fi
+
+  security:
+    name: Security Audit
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Run security audit
+        run: yarn audit --level moderate || true
+
+      - name: Check for known vulnerabilities
+        uses: snyk/actions/node@master
+        continue-on-error: true
+        env:
+          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
+        with:
+          args: --severity-threshold=high
+

package/.github/workflows/homebrew-tap.yml

@@ -0,0 +1,63 @@
+name: Homebrew Tap Update
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to update (e.g., 1.2.3)'
+        required: true
+        type: string
+
+jobs:
+  update-formula:
+    name: Update Homebrew Formula
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout homebrew tap
+        uses: actions/checkout@v4
+        with:
+          repository: hathbanger/homebrew-httpcat
+          token: ${{ secrets.GITHUB_TOKEN }}
+          path: homebrew-tap
+
+      - name: Get npm package SHA256
+        id: npm-sha
+        run: |
+          VERSION="${{ github.event.inputs.version }}"
+          TARBALL_URL="https://registry.npmjs.org/httpcat-cli/-/httpcat-cli-${VERSION}.tgz"
+          
+          echo "Downloading tarball to calculate SHA256..."
+          curl -L -o package.tgz "$TARBALL_URL"
+          SHA256=$(shasum -a 256 package.tgz | cut -d' ' -f1)
+          echo "sha256=$SHA256" >> $GITHUB_OUTPUT
+          echo "✅ SHA256: $SHA256"
+
+      - name: Update Homebrew formula
+        run: |
+          VERSION="${{ github.event.inputs.version }}"
+          SHA256="${{ steps.npm-sha.outputs.sha256 }}"
+          FORMULA_FILE="homebrew-tap/Formula/httpcat.rb"
+          
+          # Update version
+          sed -i.bak "s|url \".*httpcat-cli-.*\.tgz\"|url \"https://registry.npmjs.org/httpcat-cli/-/httpcat-cli-${VERSION}.tgz\"|" "$FORMULA_FILE"
+          
+          # Update SHA256
+          sed -i.bak "s|sha256 \".*\"|sha256 \"${SHA256}\"|" "$FORMULA_FILE"
+          
+          # Update test version
+          sed -i.bak "s|assert_match \".*\"|assert_match \"${VERSION}\"|" "$FORMULA_FILE"
+          
+          rm -f "${FORMULA_FILE}.bak"
+          
+          echo "✅ Updated Homebrew formula:"
+          cat "$FORMULA_FILE"
+
+      - name: Commit and push
+        run: |
+          cd homebrew-tap
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/httpcat.rb
+          git commit -m "Update httpcat to ${{ github.event.inputs.version }}" || exit 0
+          git push
+

package/.github/workflows/release.yml

@@ -0,0 +1,361 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'  # Triggers on semantic version tags (e.g., v1.2.3)
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g., 1.2.3)'
+        required: true
+        type: string
+
+env:
+  NODE_VERSION: '20'
+  REGISTRY_URL: 'https://registry.npmjs.org'
+
+jobs:
+  # Job 1: Validate and prepare release
+  prepare:
+    name: Prepare Release
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      tag: ${{ steps.version.outputs.tag }}
+      npm-version: ${{ steps.version.outputs.npm-version }}
+      release-notes: ${{ steps.notes.outputs.notes }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history for changelog generation
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          registry-url: ${{ env.REGISTRY_URL }}
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            VERSION="${{ github.event.inputs.version }}"
+            # Remove 'v' prefix if present
+            VERSION=${VERSION#v}
+          else
+            # Extract from tag (e.g., v1.2.3 -> 1.2.3)
+            VERSION=${GITHUB_REF#refs/tags/v}
+          fi
+          
+          # Validate semantic version format
+          if ! echo "$VERSION" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9-]+(\.[0-9]+)?)?$'; then
+            echo "❌ Invalid version format: $VERSION"
+            echo "Expected format: X.Y.Z or X.Y.Z-prerelease"
+            exit 1
+          fi
+          
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag=v$VERSION" >> $GITHUB_OUTPUT
+          echo "npm-version=$VERSION" >> $GITHUB_OUTPUT
+          echo "✅ Version: $VERSION"
+
+      - name: Verify version in package.json
+        run: |
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          RELEASE_VERSION="${{ steps.version.outputs.version }}"
+          
+          if [ "$CURRENT_VERSION" != "$RELEASE_VERSION" ]; then
+            echo "⚠️  Warning: package.json version ($CURRENT_VERSION) doesn't match release version ($RELEASE_VERSION)"
+            echo "Updating package.json..."
+            npm version "$RELEASE_VERSION" --no-git-tag-version --allow-same-version
+          fi
+
+      - name: Generate release notes
+        id: notes
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { data: releases } = await github.rest.repos.listReleases({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              per_page: 1
+            });
+            
+            const lastTag = releases.length > 0 ? releases[0].tag_name : null;
+            const currentTag = 'v${{ steps.version.outputs.version }}';
+            
+            // Get commits since last release
+            let baseSha;
+            if (lastTag) {
+              try {
+                const { data: tagData } = await github.rest.git.getRef({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  ref: `tags/${lastTag}`
+                });
+                baseSha = tagData.object.sha;
+              } catch (e) {
+                // If tag ref doesn't exist, try to get commit from tag
+                const { data: tagData } = await github.rest.repos.getCommit({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  ref: lastTag
+                });
+                baseSha = tagData.sha;
+              }
+            } else {
+              // Get the first commit or main branch
+              const { data: branchData } = await github.rest.repos.getBranch({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                branch: 'main'
+              });
+              baseSha = branchData.commit.sha;
+            }
+            
+            const { data: commits } = await github.rest.repos.compareCommits({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              base: baseSha,
+              head: context.sha
+            });
+            
+            // Categorize commits
+            const features = [];
+            const fixes = [];
+            const docs = [];
+            const chore = [];
+            const breaking = [];
+            
+            for (const commit of commits.commits) {
+              const message = commit.commit.message;
+              const firstLine = message.split('\n')[0];
+              
+              if (firstLine.match(/^BREAKING/)) {
+                breaking.push(`- ${firstLine.replace(/^BREAKING[:\s]+/i, '')}`);
+              } else if (firstLine.match(/^feat(ure)?[(:]/i)) {
+                features.push(`- ${firstLine.replace(/^feat(ure)?[(:]\s*/i, '')}`);
+              } else if (firstLine.match(/^fix[(]/i)) {
+                fixes.push(`- ${firstLine.replace(/^fix[(]\s*/i, '')}`);
+              } else if (firstLine.match(/^doc(s)?[(]/i)) {
+                docs.push(`- ${firstLine.replace(/^doc(s)?[(]\s*/i, '')}`);
+              } else if (!firstLine.match(/^(chore|ci|test|build)[(:]/i)) {
+                chore.push(`- ${firstLine}`);
+              }
+            }
+            
+            let notes = `## 🎉 Release ${{ steps.version.outputs.version }}\n\n`;
+            
+            if (breaking.length > 0) {
+              notes += `### ⚠️ Breaking Changes\n${breaking.join('\n')}\n\n`;
+            }
+            
+            if (features.length > 0) {
+              notes += `### ✨ Features\n${features.join('\n')}\n\n`;
+            }
+            
+            if (fixes.length > 0) {
+              notes += `### 🐛 Bug Fixes\n${fixes.join('\n')}\n\n`;
+            }
+            
+            if (docs.length > 0) {
+              notes += `### 📚 Documentation\n${docs.join('\n')}\n\n`;
+            }
+            
+            if (chore.length > 0 && chore.length < 10) {
+              notes += `### 🔧 Other Changes\n${chore.join('\n')}\n\n`;
+            }
+            
+            notes += `### 📦 Installation\n\n`;
+            notes += `\`\`\`bash\n`;
+            notes += `# npm\n`;
+            notes += `npm install -g httpcat-cli@${{ steps.version.outputs.version }}\n\n`;
+            notes += `# Homebrew\n`;
+            notes += `brew upgrade httpcat\n`;
+            notes += `\`\`\`\n\n`;
+            notes += `---\n\n`;
+            notes += `**Full Changelog**: https://github.com/${{ github.repository }}/compare/${lastTag || 'main'}...${currentTag}`;
+            
+            core.setOutput('notes', notes);
+            console.log('Generated release notes');
+
+  # Job 2: Build and test
+  test:
+    name: Build & Test
+    runs-on: ubuntu-latest
+    needs: prepare
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Run linter (if configured)
+        continue-on-error: true
+        run: |
+          if [ -f ".eslintrc" ] || [ -f ".eslintrc.js" ] || [ -f ".eslintrc.json" ]; then
+            yarn lint
+          else
+            echo "No linter configured, skipping..."
+          fi
+
+      - name: Run tests
+        run: yarn test
+
+      - name: Build
+        run: yarn build
+
+      - name: Verify build output
+        run: |
+          if [ ! -f "dist/index.js" ]; then
+            echo "❌ Build failed: dist/index.js not found"
+            exit 1
+          fi
+          echo "✅ Build successful"
+
+  # Job 3: Publish to npm
+  publish-npm:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+    needs: [prepare, test]
+    environment:
+      name: npm-publish
+      url: https://www.npmjs.com/package/httpcat-cli
+    permissions:
+      contents: read
+      id-token: write  # For npm provenance
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          registry-url: ${{ env.REGISTRY_URL }}
+
+      - name: Update package.json version
+        run: |
+          npm version "${{ needs.prepare.outputs.version }}" --no-git-tag-version --allow-same-version
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Build
+        run: yarn build
+
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Verify npm publication
+        run: |
+          sleep 5  # Wait for npm CDN propagation
+          VERSION="${{ needs.prepare.outputs.version }}"
+          if npm view httpcat-cli@$VERSION version > /dev/null 2>&1; then
+            echo "✅ Successfully published httpcat-cli@$VERSION to npm"
+          else
+            echo "❌ Failed to verify npm publication"
+            exit 1
+          fi
+
+  # Job 4: Update Homebrew formula
+  update-homebrew:
+    name: Update Homebrew Formula
+    runs-on: ubuntu-latest
+    needs: [prepare, publish-npm]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Wait for npm CDN propagation
+        run: |
+          VERSION="${{ needs.prepare.outputs.version }}"
+          echo "Waiting for npm package to be available..."
+          for i in {1..30}; do
+            if npm view httpcat-cli@$VERSION version > /dev/null 2>&1; then
+              echo "✅ Package is available on npm"
+              break
+            fi
+            echo "Attempt $i/30: Package not yet available, waiting 10s..."
+            sleep 10
+          done
+
+      - name: Get npm package SHA256
+        id: npm-sha
+        run: |
+          VERSION="${{ needs.prepare.outputs.version }}"
+          TARBALL_URL="https://registry.npmjs.org/httpcat-cli/-/httpcat-cli-${VERSION}.tgz"
+          
+          echo "Downloading tarball to calculate SHA256..."
+          curl -L -o package.tgz "$TARBALL_URL"
+          SHA256=$(shasum -a 256 package.tgz | cut -d' ' -f1)
+          echo "sha256=$SHA256" >> $GITHUB_OUTPUT
+          echo "✅ SHA256: $SHA256"
+
+      - name: Update Homebrew formula
+        run: |
+          VERSION="${{ needs.prepare.outputs.version }}"
+          SHA256="${{ steps.npm-sha.outputs.sha256 }}"
+          FORMULA_FILE="homebrew-httpcat/Formula/httpcat.rb"
+          
+          # Update version
+          sed -i.bak "s|url \".*httpcat-cli-.*\.tgz\"|url \"https://registry.npmjs.org/httpcat-cli/-/httpcat-cli-${VERSION}.tgz\"|" "$FORMULA_FILE"
+          
+          # Update SHA256
+          sed -i.bak "s|sha256 \".*\"|sha256 \"${SHA256}\"|" "$FORMULA_FILE"
+          
+          # Update test version
+          sed -i.bak "s|assert_match \".*\"|assert_match \"${VERSION}\"|" "$FORMULA_FILE"
+          
+          rm -f "${FORMULA_FILE}.bak"
+          
+          echo "✅ Updated Homebrew formula:"
+          cat "$FORMULA_FILE"
+
+      - name: Commit and push Homebrew formula update
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add homebrew-httpcat/Formula/httpcat.rb
+          git commit -m "chore: update Homebrew formula to v${{ needs.prepare.outputs.version }}" || exit 0
+          git push
+
+  # Job 5: Create GitHub Release
+  create-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: [prepare, publish-npm, update-homebrew]
+    permissions:
+      contents: write
+    steps:
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ needs.prepare.outputs.tag }}
+          name: Release ${{ needs.prepare.outputs.version }}
+          body: ${{ needs.prepare.outputs.release-notes }}
+          draft: false
+          prerelease: ${{ contains(needs.prepare.outputs.version, '-') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Release summary
+        run: |
+          echo "✅ Release created successfully!"
+          echo "Tag: ${{ needs.prepare.outputs.tag }}"
+          echo "Version: ${{ needs.prepare.outputs.version }}"
+          echo "npm: https://www.npmjs.com/package/httpcat-cli/v/${{ needs.prepare.outputs.version }}"
+          echo "GitHub: https://github.com/${{ github.repository }}/releases/tag/${{ needs.prepare.outputs.tag }}"