buildx-cli 1.0.0

package/.github/workflows/auto-publish.yml

@@ -0,0 +1,242 @@
+name: Auto Publish and Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - '**.md'
+      - 'README.md'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  packages: write
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'yarn'
+
+      - name: Check if NPM_TOKEN is set
+        run: |
+          if [ -z "$NPM_TOKEN" ]; then
+            echo "NPM_TOKEN is not set"
+            exit 1
+          fi
+          echo "NPM_TOKEN is set"
+          echo "Token length: ${#NPM_TOKEN}"
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Setup npm authentication
+        run: |
+          echo "Setting up npm authentication..."
+          npm config set '//registry.npmjs.org/:_authToken' "${NPM_TOKEN}"
+          echo "NPM authentication configured"
+          echo "Testing authentication..."
+          npm whoami
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Install dependencies with dev dependencies
+        run: yarn install
+
+      - name: Run validate
+        run: yarn validate
+
+      - name: Determine version bump type
+        id: version-bump
+        run: |
+          # Get the last commit message
+          COMMIT_MSG=$(git log -1 --pretty=%B)
+          echo "Commit message: $COMMIT_MSG"
+          
+          # Check for version bump indicators in commit message
+          if echo "$COMMIT_MSG" | grep -q "\[major\]\|\[breaking\]"; then
+            echo "bump_type=major" >> $GITHUB_OUTPUT
+            echo "Version bump: MAJOR (from commit message)"
+          elif echo "$COMMIT_MSG" | grep -q "\[minor\]\|\[feature\]"; then
+            echo "bump_type=minor" >> $GITHUB_OUTPUT
+            echo "Version bump: MINOR (from commit message)"
+          elif echo "$COMMIT_MSG" | grep -q "\[patch\]\|\[fix\]\|\[bug\]"; then
+            echo "bump_type=patch" >> $GITHUB_OUTPUT
+            echo "Version bump: PATCH (from commit message)"
+          else
+            echo "bump_type=patch" >> $GITHUB_OUTPUT
+            echo "Version bump: PATCH (automatic fallback)"
+          fi
+
+      - name: Bump version and publish
+        run: |
+          # Configure git
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          
+          # Get bump type
+          BUMP_TYPE=${{ steps.version-bump.outputs.bump_type }}
+          
+          # Show current version
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          echo "Current version: $CURRENT_VERSION"
+          
+          # Show package info
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          echo "Package name: $PACKAGE_NAME"
+          
+          # Check npm registry
+          echo "NPM registry: $(npm config get registry)"
+          
+          # Check if logged in
+          echo "NPM whoami:"
+          npm whoami || echo "Not logged in to npm"
+          
+          # Bump version using yarn (without git operations)
+          yarn version --$BUMP_TYPE --message "chore: bump version to $NEW_VERSION [skip ci]"
+          
+          # Get new version
+          NEW_VERSION=$(node -p "require('./package.json').version")
+          echo "New version: $NEW_VERSION"
+
+          # Build project
+          yarn build
+          
+          # Push changes
+          git push origin HEAD:main
+          
+          # Create and push tag
+          git push origin "v$NEW_VERSION"
+          
+          # Publish to npm using yarn with public access
+          echo "Publishing to npm..."
+          echo "Package: $PACKAGE_NAME"
+          echo "Version: $NEW_VERSION"
+
+          npm publish ./build --access public
+          
+          echo "✅ Published version $NEW_VERSION to npm"
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Generate documentation
+        run: |
+          echo "Generating documentation..."
+          yarn docs:clean
+          yarn docs
+          echo "✅ Documentation generated"
+
+      - name: Commit and push documentation
+        run: |
+          # Configure git
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          
+          # Check if there are changes in docs
+          if git diff --quiet docs/; then
+            echo "No documentation changes to commit"
+          else
+            # Add documentation changes
+            git add docs/
+            
+            # Get the new version
+            NEW_VERSION=$(node -p "require('./package.json').version")
+            
+            # Commit with [doc] tag
+            git commit -m "[doc] Update documentation for version $NEW_VERSION"
+            
+            # Push documentation changes
+            git push origin HEAD:main
+            
+            echo "✅ Documentation committed and pushed"
+          fi
+
+      - name: Update develop branch with new version
+        run: |
+          # Configure git
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          
+          # Get the new version that was just published
+          NEW_VERSION=$(node -p "require('./package.json').version")
+          echo "Updating develop branch with version: $NEW_VERSION"
+          
+          # Fetch all branches
+          git fetch origin
+          
+          # Checkout develop branch
+          git checkout develop
+          
+          # Now merge the documentation changes from main
+          echo "Merging documentation changes from main..."
+          
+          # Try to merge with strategy to handle conflicts
+          if git merge origin/main --no-edit -m "chore: merge docs from main [skip ci]" --strategy=recursive -X theirs; then
+            echo "✅ Merge successful"
+          else
+            echo "⚠️ Merge conflict detected, resolving..."
+            
+            # Check if there are conflicts
+            if git diff --name-only --diff-filter=U | grep -q .; then
+              echo "Resolving conflicts by keeping main version for docs..."
+              
+              # For docs conflicts, keep the main version
+              git checkout --theirs docs/
+              git add docs/
+              
+              # For package.json conflicts, keep the develop version (with updated version)
+              git checkout --ours package.json
+              git add package.json
+              
+              # Complete the merge
+              git commit -m "chore: resolve merge conflicts, keep main docs and develop version [skip ci]"
+            else
+              echo "No conflicts to resolve"
+            fi
+          fi
+          
+          # Push all changes to develop
+          git push origin develop
+          
+          echo "✅ Updated develop branch with version $NEW_VERSION and documentation changes"
+          
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs/api/html
+          destination: ./_site
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+      - name: Cleanup uncommitted changes
+        run: |
+          git clean -f
+          echo "✅ Cleanup completed"

package/.github/workflows/create-pr.yml

@@ -0,0 +1,182 @@
+name: Create Pull Request for Deployment
+on:
+  push:
+    branches:
+      - develop
+      - staging
+      - feature/*
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - 'README.md'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  create-pr:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Run validate
+        run: yarn validate
+          
+      - name: Build project
+        run: yarn build
+
+      - name: Fetch main and develop
+        run: |
+          git fetch origin main
+          git fetch origin develop
+
+      - name: Check diff
+        id: diff
+        run: |
+          COUNT=$(git rev-list --right-only --count origin/main...origin/develop)
+          echo "commits_ahead=$COUNT"
+          echo "commits_ahead=$COUNT" >> "$GITHUB_OUTPUT"
+
+      - name: Get repository collaborators
+        id: collaborators
+        if: steps.diff.outputs.commits_ahead != '0'
+        run: |
+          # Get all collaborators with write/admin access
+          COLLABORATORS=$(gh api repos/${{ github.repository }}/collaborators --jq '.[] | select(.permissions.admin == true or .permissions.maintain == true or .permissions.push == true) | .login' | tr '\n' ',' | sed 's/,$//')
+          echo "collaborators=$COLLABORATORS" >> $GITHUB_OUTPUT
+          
+          # Get team members using GraphQL (more efficient)
+          TEAM_MEMBERS=$(gh api graphql -F query='
+              query($org: String!) {
+                organization(login: $org) {
+                  teams(first: 100) {
+                    nodes {
+                      members(first: 100) {
+                        nodes {
+                          login
+                        }
+                      }
+                    }
+                  }
+                }
+              }' -F org="${{ github.repository_owner }}" --jq '.data.organization.teams.nodes[].members.nodes[].login' 2>/dev/null | tr '\n' ',' | sed 's/,$//' || echo "")
+          
+          echo "team_members=$TEAM_MEMBERS" >> $GITHUB_OUTPUT
+
+      - name: Check if PR creator is the only eligible reviewer
+        id: check_eligibility
+        if: steps.diff.outputs.commits_ahead != '0'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          PR_CREATOR="${{ github.actor }}"
+          COLLABORATORS="${{ steps.collaborators.outputs.collaborators }}"
+          TEAM_MEMBERS="${{ steps.collaborators.outputs.team_members }}"
+          
+          # Combine all eligible reviewers
+          ALL_REVIEWERS=""
+          if [ ! -z "$COLLABORATORS" ]; then
+            ALL_REVIEWERS="$COLLABORATORS"
+          fi
+          if [ ! -z "$TEAM_MEMBERS" ]; then
+            if [ ! -z "$ALL_REVIEWERS" ]; then
+              ALL_REVIEWERS="$ALL_REVIEWERS,$TEAM_MEMBERS"
+            else
+              ALL_REVIEWERS="$TEAM_MEMBERS"
+            fi
+          fi
+          
+          # Remove duplicates and the PR creator
+          UNIQUE_REVIEWERS=$(echo "$ALL_REVIEWERS" | tr ',' '\n' | grep -v "^$PR_CREATOR$" | sort -u | tr '\n' ',' | sed 's/,$//')
+          
+          # Count unique reviewers (excluding PR creator)
+          REVIEWER_COUNT=$(echo "$UNIQUE_REVIEWERS" | tr ',' '\n' | grep -v "^$" | wc -l)
+          
+          echo "reviewer_count=$REVIEWER_COUNT" >> $GITHUB_OUTPUT
+          echo "unique_reviewers=$UNIQUE_REVIEWERS" >> $GITHUB_OUTPUT
+          echo "pr_creator=$PR_CREATOR" >> $GITHUB_OUTPUT
+          
+          # Check if PR creator is the only eligible reviewer
+          if [ "$REVIEWER_COUNT" -eq 0 ]; then
+            echo "is_only_reviewer=true" >> $GITHUB_OUTPUT
+            echo "Auto-assigning deployment PR to $PR_CREATOR (only eligible reviewer)"
+          else
+            echo "is_only_reviewer=false" >> $GITHUB_OUTPUT
+            echo "Deployment PR has $REVIEWER_COUNT other eligible reviewers: $UNIQUE_REVIEWERS"
+          fi
+
+      - name: Create deployment PR
+        if: steps.diff.outputs.commits_ahead != '0'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          BRANCH="deploy/${{ github.ref_name }}-${{ github.sha }}"
+
+          git config --global user.name  "github-actions"
+          git config --global user.email "github-actions@github.com"
+
+          git checkout -b "$BRANCH" refs/remotes/origin/develop
+          git push -u origin "$BRANCH"
+
+          # Ensure labels exist
+          gh label create deployment --description "Deployment PR" --color "#1d76db" --force || true
+          gh label create auto-generated --description "Created by GitHub Action" --color "#ededed" --force || true
+          gh label create auto-assigned --description "Auto-assigned to author" --color "#0366d6" --force || true
+
+          # Determine assignee and reviewers based on eligibility check
+          if [ "${{ steps.check_eligibility.outputs.is_only_reviewer }}" == "true" ]; then
+            ASSIGNEE="${{ steps.check_eligibility.outputs.pr_creator }}"
+            LABELS="deployment,auto-generated,auto-assigned"
+            REVIEWERS=""
+            echo "Auto-assigning deployment PR to $ASSIGNEE (only eligible reviewer)"
+          else
+            ASSIGNEE="${{ github.actor }}"
+            LABELS="deployment,auto-generated"
+            REVIEWERS="${{ steps.check_eligibility.outputs.unique_reviewers }}"
+            echo "Assigning deployment PR to $ASSIGNEE with reviewers: $REVIEWERS"
+          fi
+
+          # Create PR with or without reviewers
+          if [ -z "$REVIEWERS" ]; then
+            gh pr create \
+              --base main \
+              --head "$BRANCH" \
+              --title "🚀 Deploy: ${BRANCH#deploy/} → main" \
+              --body "Auto-generated deployment PR for **${{ github.ref_name }}**
+
+          $([ "${{ steps.check_eligibility.outputs.is_only_reviewer }}" == "true" ] && echo "🤖 Auto-assigned to $ASSIGNEE (only eligible reviewer)" || echo "👥 Assigned to $ASSIGNEE (other reviewers available: ${{ steps.check_eligibility.outputs.unique_reviewers }})")" \
+              --label "$LABELS" \
+              --assignee "$ASSIGNEE"
+          else
+            gh pr create \
+              --base main \
+              --head "$BRANCH" \
+              --title "🚀 Deploy: ${BRANCH#deploy/} → main" \
+              --body "Auto-generated deployment PR for **${{ github.ref_name }}**
+
+          $([ "${{ steps.check_eligibility.outputs.is_only_reviewer }}" == "true" ] && echo "🤖 Auto-assigned to $ASSIGNEE (only eligible reviewer)" || echo "👥 Assigned to $ASSIGNEE with reviewers: $REVIEWERS")" \
+              --label "$LABELS" \
+              --assignee "$ASSIGNEE" \
+              --reviewer "$REVIEWERS"
+          fi
+
+      - name: No diff – skip PR
+        if: steps.diff.outputs.commits_ahead == '0'
+        run: echo "develop is identical to main – no deployment PR needed."

package/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 80,
+  "tabWidth": 4,
+  "useTabs": true
+} 

package/README.md

@@ -0,0 +1,179 @@
+# BuildX CLI
+
+A command-line interface tool for BuildX API with authentication and schema synchronization capabilities.
+
+## Features
+
+- **Authentication Management**: Store and manage API tokens securely
+- **Schema Synchronization**: Generate TypeScript types from API schema
+- **Project Management**: Handle multiple project configurations
+- **Interactive CLI**: User-friendly command-line interface
+
+## Installation
+
+### Global Installation
+```bash
+npm install -g buildx-cli
+```
+
+### Local Development
+```bash
+git clone <repository-url>
+cd buildx-cli
+npm install
+npm run build
+```
+
+## Usage
+
+### Authentication
+
+#### Login with token
+```bash
+buildx login --token <your-api-token>
+```
+
+#### Interactive login
+```bash
+buildx login
+```
+
+#### Logout
+```bash
+buildx logout
+```
+
+#### Check authentication status
+```bash
+buildx auth:status
+```
+
+### Schema Synchronization
+
+#### Sync schema for a project
+```bash
+buildx sync --project-id <project-id>
+```
+
+#### Sync schema with custom output path
+```bash
+buildx sync --project-id <project-id> --output ./src/types/generated.ts
+```
+
+#### Sync schema with custom API base URL
+```bash
+buildx sync --project-id <project-id> --api-url https://custom-api.example.com
+```
+
+### Project Management
+
+#### List projects
+```bash
+buildx projects:list
+```
+
+#### Set default project
+```bash
+buildx projects:set-default <project-id>
+```
+
+#### Get current project
+```bash
+buildx projects:current
+```
+
+## Configuration
+
+The CLI stores configuration in the following locations:
+- **Global config**: `~/.config/buildx-cli/config.json`
+- **Project config**: `./buildx.json` (optional)
+
+### Configuration File Structure
+
+```json
+{
+  "auth": {
+    "token": "your-api-token",
+    "expiresAt": "2024-01-01T00:00:00.000Z"
+  },
+  "projects": {
+    "default": "project-id",
+    "list": [
+      {
+        "id": "project-id",
+        "name": "Project Name",
+        "apiUrl": "https://api.bbb.com"
+      }
+    ]
+  },
+  "sync": {
+    "outputPath": "./generated/types.ts",
+    "apiBaseUrl": "https://api.bbb.com"
+  }
+}
+```
+
+## API Endpoints
+
+The CLI interacts with the following API endpoints:
+
+- `GET /:project_id/collections/schema` - Fetch project schema
+- `GET /projects` - List user projects
+- `POST /auth/validate` - Validate authentication token
+
+## Development
+
+### Project Structure
+
+```
+src/
+├── commands/          # CLI commands
+├── services/          # Business logic services
+├── types/            # TypeScript type definitions
+├── utils/            # Utility functions
+├── config/           # Configuration management
+└── index.ts          # Main entry point
+```
+
+### Building
+
+```bash
+npm run build
+```
+
+### Development Mode
+
+```bash
+npm run dev
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+### Linting
+
+```bash
+npm run lint
+```
+
+### Formatting
+
+```bash
+npm run format
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Run the test suite
+6. Submit a pull request
+
+## License
+
+MIT License - see LICENSE file for details.