CTX7-855: Context7 TS SDK docs

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/config.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://unpkg.com/@changesets/[email protected]/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "master",
+  "updateInternalDependencies": "patch",
+  "ignore": [],
+  "snapshot": {
+    "useCalculatedVersion": true,
+    "prereleaseTemplate": "{tag}-{datetime}"
+  }
+}

.changeset/heavy-papers-invent.md

@@ -0,0 +1,5 @@
+---
+"@upstash/context7-mcp": patch
+---
+
+Migrate to pnpm monorepo structure

.github/workflows/canary-release.yml

@@ -0,0 +1,46 @@
+name: Canary Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: "Branch to release from (defaults to current branch)"
+        required: false
+        type: string
+
+jobs:
+  canary-release:
+    name: Canary Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ inputs.branch || github.ref }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Configure npm authentication
+        run: |
+          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > ~/.npmrc
+
+      - name: Install Dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build all packages
+        run: pnpm build
+
+      - name: Publish Snapshot
+        run: pnpm release:snapshot
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/changeset-check.yml

@@ -0,0 +1,47 @@
+name: Changeset Check
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, labeled, unlabeled]
+
+jobs:
+  check:
+    name: Check for Changeset
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Check for changeset
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { execSync } = require('child_process');
+
+            const labels = context.payload.pull_request.labels.map(l => l.name);
+            if (labels.includes('skip-changeset')) {
+              console.log('Skipping changeset check for PR with skip-changeset label');
+              return;
+            }
+
+            const baseSha = context.payload.pull_request.base.sha;
+            const headSha = context.payload.pull_request.head.sha;
+
+            const diff = execSync(
+              `git diff --name-only ${baseSha}...${headSha}`,
+              { encoding: 'utf-8' }
+            );
+
+            const hasChangeset = diff
+              .split('\n')
+              .some(file => file.startsWith('.changeset/') && file.endsWith('.md') && !file.includes('README'));
+
+            if (!hasChangeset) {
+              core.setFailed(
+                'No changeset found. Please add a changeset using `pnpm changeset` or add the "skip-changeset" label if this PR doesn\'t need one (e.g., docs, CI changes).'
+              );
+            } else {
+              console.log('Changeset found!');
+            }

.github/workflows/check.yaml

@@ -18,27 +18,38 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
-          bun-version: latest
+          node-version: "20"
 
-      - name: Cache dependencies
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - name: Cache pnpm dependencies
         uses: actions/cache@v4
         with:
-          path: ~/.bun/install/cache
-          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
+          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
           restore-keys: |
-            ${{ runner.os }}-bun-
+            ${{ runner.os }}-pnpm-store-
 
       - name: Install dependencies
-        run: bun install --frozen-lockfile
+        run: pnpm install --frozen-lockfile
 
       - name: Run linter
-        run: bun run lint:check
+        run: pnpm run lint:check
 
       - name: Check formatting
-        run: bun run format --check
+        run: pnpm run format:check
 
       - name: Build project
-        run: bun run build
+        run: pnpm run build

.github/workflows/ecr-deploy.yml

@@ -34,7 +34,8 @@ jobs:
         id: build-push
         uses: docker/build-push-action@v5
         with:
-          context: .
+          context: packages/mcp
+          file: packages/mcp/Dockerfile
           platforms: linux/amd64
           push: true
           tags: |

.github/workflows/publish-mcp.yml

@@ -31,7 +31,7 @@ jobs:
             # Remove 'v' prefix if it exists
             VERSION="${VERSION#v}"
           else
-            VERSION=$(node -p "require('./package.json').version")
+            VERSION=$(node -p "require('./packages/mcp/package.json').version")
           fi
           echo "VERSION=$VERSION" >> $GITHUB_ENV
           echo "Publishing version: $VERSION"

.github/workflows/release.yml

@@ -1,84 +1,89 @@
 name: Release
 
 on:
-  release:
-    types:
-      - published
+  push:
+    branches:
+      - master
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
 
 jobs:
   release:
     name: Release
     runs-on: ubuntu-latest
     permissions:
       id-token: write # Required for OIDC authentication with MCP Registry
-      contents: read
+      contents: write
+      pull-requests: write
     steps:
       - name: Checkout Repo
         uses: actions/checkout@v3
 
-      - name: Set env
-        run: |
-          VERSION="${GITHUB_REF##refs/*/}"
-          # Remove 'v' prefix if it exists
-          VERSION="${VERSION#v}"
-          echo "VERSION=$VERSION" >> $GITHUB_ENV
-
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: lts/*
+          node-version: "20"
 
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
         with:
-          bun-version: latest
+          version: 9
 
-      - name: Set package version
+      - name: Configure npm authentication
         run: |
-          echo $(jq --arg v "${{ env.VERSION }}" '(.version) = $v' package.json) > package.json
-
-      - name: Update version in source file
-        run: |
-          sed -i "s/version: \"[0-9]*\.[0-9]*\.[0-9]*\"/version: \"${{ env.VERSION }}\"/" src/index.ts
-
-      - name: Update package version in server.json
-        run: |
-          echo $(jq --arg v "${{ env.VERSION }}" '.version = $v | .packages[0].version = $v' server.json) > server.json
+          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > ~/.npmrc
 
       - name: Install Dependencies
-        run: bun install
-
-      - name: Build
-        run: bun run build
+        run: pnpm install --frozen-lockfile
 
-      - name: Set NPM_TOKEN
-        run: npm config set //registry.npmjs.org/:_authToken=${{secrets.NPM_TOKEN}}
+      - name: Build all packages
+        run: pnpm build
 
-      - name: Publish
-        if: "!github.event.release.prerelease"
+      - name: Create Release PR or Publish
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          publish: pnpm release
+          commit: "chore(release): version packages"
+          title: "chore(release): version packages"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Check if MCP was published
+        id: check-mcp
+        if: steps.changesets.outputs.published == 'true'
         run: |
-          npm pkg delete scripts.prepare
-          npm publish --access public
-
-      - name: Publish release candidate
-        if: "github.event.release.prerelease"
+          PUBLISHED='${{ steps.changesets.outputs.publishedPackages }}'
+          if echo "$PUBLISHED" | jq -e '.[] | select(.name == "@upstash/context7-mcp")' > /dev/null; then
+            VERSION=$(echo "$PUBLISHED" | jq -r '.[] | select(.name == "@upstash/context7-mcp") | .version')
+            echo "mcp_published=true" >> $GITHUB_OUTPUT
+            echo "mcp_version=$VERSION" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Update version in MCP source file
+        if: steps.check-mcp.outputs.mcp_published == 'true'
         run: |
-          npm pkg delete scripts.prepare
-          npm publish --access public --tag=canary
-
-      - name: Validate server.json
-        if: "!github.event.release.prerelease"
-        run: npx mcp-registry-validator validate server.json
-
-      - name: Install MCP Publisher
-        if: "!github.event.release.prerelease"
+          VERSION="${{ steps.check-mcp.outputs.mcp_version }}"
+          sed -i "s/version: \"[0-9]*\.[0-9]*\.[0-9]*\"/version: \"$VERSION\"/" packages/mcp/src/index.ts
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add packages/mcp/src/index.ts
+          git commit -m "chore: update MCP version in source to $VERSION" || true
+          git push || true
+
+      - name: Update server.json
+        if: steps.check-mcp.outputs.mcp_published == 'true'
         run: |
-          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.3.3/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
-
-      - name: Login to MCP Registry
-        if: "!github.event.release.prerelease"
-        run: ./mcp-publisher login github-oidc
+          VERSION="${{ steps.check-mcp.outputs.mcp_version }}"
+          echo $(jq --arg v "$VERSION" '.version = $v | .packages[0].version = $v' server.json) > server.json
+          git add server.json
+          git commit -m "chore: update server.json to v$VERSION" || true
+          git push || true
 
       - name: Publish to MCP Registry
-        if: "!github.event.release.prerelease"
-        run: ./mcp-publisher publish
+        if: steps.check-mcp.outputs.mcp_published == 'true'
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.3.3/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+          ./mcp-publisher login github-oidc
+          ./mcp-publisher publish

.prettierignore

@@ -0,0 +1,28 @@
+# Dependencies
+node_modules
+
+# Lock files
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+bun.lockb
+
+# Build outputs
+dist
+build
+.next
+out
+
+# Logs
+*.log
+
+# Environment files
+.env
+.env.*
+
+# IDE
+.vscode
+.idea
+
+# Changesets
+.changeset/*.md