Feat/n8n v2 docs

.github/workflows/check.yml

@@ -5,6 +5,10 @@ on:
     branches:
       - main
 
+concurrency:
+  group: check-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   check:
     name: Lint, typecheck, format

.github/workflows/deploy.yml

@@ -6,6 +6,10 @@ on:
     branches:
       - main
 
+concurrency:
+  group: deploy
+  cancel-in-progress: false
+
 jobs:
   build-site:
     name: Build & push image

.github/workflows/generator.yml

@@ -18,19 +18,15 @@ on:
 
 concurrency:
   group: generator-${{ github.ref }}
-  cancel-in-progress: true
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 
 jobs:
   snapshot-tests:
     name: Snapshot tests
     runs-on: ubuntu-latest
-    outputs:
-      changed: ${{ steps.check.outputs.changed }}
     steps:
       - name: Checkout repo
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
@@ -48,15 +44,8 @@ jobs:
         working-directory: packages/generator
         run: bun test
 
-      - name: Check for generator changes
-        if: github.event_name == 'push'
-        id: check
-        run: |
-          CHANGED=$(git diff --name-only HEAD~1 HEAD -- packages/generator/ packages/openapi-parser/ | grep -q . && echo true || echo false)
-          echo "changed=$CHANGED" >> $GITHUB_OUTPUT
-
   publish-generator:
-    if: github.event_name == 'push' && needs.snapshot-tests.outputs.changed == 'true'
+    if: github.event_name == 'push'
     needs: snapshot-tests
     runs-on: ubuntu-latest
     concurrency:
@@ -84,14 +73,40 @@ jobs:
         working-directory: packages/generator
         run: bun run build
 
+      - name: Set version (auto-increment patch)
+        id: version
+        working-directory: packages/generator
+        run: |
+          VERSION=$(node -e "
+            const { execSync } = require('child_process');
+            const base = require('./package.json').version.split('.').slice(0, 2).join('.');
+            let versions = [];
+            try {
+              const raw = execSync('npm view @pachca/generator versions --json', { stdio: ['pipe', 'pipe', 'pipe'] }).toString().trim();
+              const parsed = JSON.parse(raw);
+              versions = Array.isArray(parsed) ? parsed : [parsed];
+            } catch {}
+            const matching = versions.filter(v => v.startsWith(base + '.'));
+            const lastPatch = matching.length > 0
+              ? Math.max(...matching.map(v => parseInt(v.split('.')[2])))
+              : -1;
+            console.log(base + '.' + (lastPatch + 1));
+          ")
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          node -e "const fs=require('fs'),p=JSON.parse(fs.readFileSync('package.json'));p.version='$VERSION';fs.writeFileSync('package.json',JSON.stringify(p,null,2)+'\n')"
+          echo "Publishing @pachca/generator@$VERSION"
+
       - name: Publish to npm
         working-directory: packages/generator
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |
-          VERSION=$(node -e "console.log(require('./package.json').version)")
-          if npm view "@pachca/generator@${VERSION}" version 2>/dev/null; then
-            echo "Version ${VERSION} already published, skipping"
-          else
-            npm publish --access public --provenance
-          fi
+          OUTPUT=$(npm publish --access public --provenance 2>&1) || {
+            CODE=$?
+            if echo "$OUTPUT" | grep -q "E409\|already exists"; then
+              echo "Version ${{ steps.version.outputs.version }} already published, skipping"
+            else
+              echo "$OUTPUT"
+              exit $CODE
+            fi
+          }

.github/workflows/gitlab.yml

@@ -4,6 +4,10 @@ on:
     branches:
       - main
 
+concurrency:
+  group: gitlab-sync
+  cancel-in-progress: false
+
 jobs:
   sync_gitlab:
     name: push github/main to gitlab/main

.github/workflows/n8n.yml

@@ -0,0 +1,204 @@
+name: n8n Node
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'integrations/n8n/**'
+      - 'packages/spec/openapi.yaml'
+      - 'packages/spec/workflows.ts'
+      - 'packages/spec/examples.ts'
+      - 'packages/openapi-parser/src/**'
+      - 'packages/generator/src/naming.ts'
+      - 'apps/docs/lib/openapi/mapper.ts'
+      - 'apps/docs/lib/openapi/example-generator.ts'
+      - 'packages/spec/overlay.en.yaml'
+      - 'packages/spec/scripts/**'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'integrations/n8n/**'
+      - 'packages/spec/openapi.yaml'
+      - 'packages/spec/workflows.ts'
+      - 'packages/spec/examples.ts'
+      - 'packages/openapi-parser/src/**'
+      - 'packages/generator/src/naming.ts'
+      - 'apps/docs/lib/openapi/mapper.ts'
+      - 'apps/docs/lib/openapi/example-generator.ts'
+      - 'packages/spec/overlay.en.yaml'
+      - 'packages/spec/scripts/**'
+  workflow_dispatch:
+
+concurrency:
+  group: n8n-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  generate-and-build:
+    name: Generate & Build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build parser
+        working-directory: packages/openapi-parser
+        run: bun run build
+
+      - name: Apply English overlay
+        working-directory: packages/spec
+        run: bun run scripts/apply-overlay.ts
+
+      - name: Generate n8n node
+        run: bun run integrations/n8n/scripts/generate-n8n.ts
+
+      - name: Type check
+        working-directory: integrations/n8n
+        run: bun run tsc --noEmit
+
+      - name: Lint
+        working-directory: integrations/n8n
+        run: bun run lint
+
+      - name: Test
+        working-directory: integrations/n8n
+        run: bun run test
+
+      - name: Build n8n node
+        working-directory: integrations/n8n
+        run: |
+          bun run tsc
+          find nodes icons credentials \( -name '*.png' -o -name '*.svg' \) | while read f; do mkdir -p "dist/$(dirname "$f")" && cp "$f" "dist/$f"; done
+
+  publish:
+    if: github.event_name == 'push'
+    needs: generate-and-build
+    runs-on: ubuntu-latest
+    concurrency:
+      group: publish-n8n
+      cancel-in-progress: false
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build parser
+        working-directory: packages/openapi-parser
+        run: bun run build
+
+      - name: Apply English overlay
+        working-directory: packages/spec
+        run: bun run scripts/apply-overlay.ts
+
+      - name: Generate n8n node
+        run: bun run integrations/n8n/scripts/generate-n8n.ts
+
+      - name: Check for publishable changes
+        id: changes
+        run: |
+          # Check committed source changes (exclude tests, scripts, docs, config)
+          COMMITTED=$(git diff --name-only HEAD~1 HEAD -- integrations/n8n/ \
+            | grep -v -E '^integrations/n8n/(tests/|scripts/|docs/|e2e/|eslint|tsconfig|\.gitignore|\.npmrc|vitest)' \
+            | grep -q . && echo true || echo false)
+          # Check if generation produced different files (spec/generator changed)
+          GENERATED=$(git diff --name-only -- integrations/n8n/nodes/ integrations/n8n/credentials/ \
+            | grep -q . && echo true || echo false)
+          if [ "$COMMITTED" = "true" ] || [ "$GENERATED" = "true" ]; then
+            echo "changed=true" >> $GITHUB_OUTPUT
+            echo "Publishable changes detected (committed=$COMMITTED, generated=$GENERATED)"
+          else
+            echo "changed=false" >> $GITHUB_OUTPUT
+            echo "No publishable changes, skipping publish"
+          fi
+
+      - name: Set version (auto-increment patch)
+        if: steps.changes.outputs.changed == 'true'
+        id: version
+        working-directory: integrations/n8n
+        run: |
+          VERSION=$(node -e "
+            const { execSync } = require('child_process');
+            const base = require('./package.json').version.split('.').slice(0, 2).join('.');
+            let versions = [];
+            try {
+              const raw = execSync('npm view n8n-nodes-pachca versions --json', { stdio: ['pipe', 'pipe', 'pipe'] }).toString().trim();
+              const parsed = JSON.parse(raw);
+              versions = Array.isArray(parsed) ? parsed : [parsed];
+            } catch {}
+            const matching = versions.filter(v => v.startsWith(base + '.'));
+            const lastPatch = matching.length > 0
+              ? Math.max(...matching.map(v => parseInt(v.split('.')[2])))
+              : -1;
+            console.log(base + '.' + (lastPatch + 1));
+          ")
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          node -e "const fs=require('fs'),p=JSON.parse(fs.readFileSync('package.json'));p.version='$VERSION';fs.writeFileSync('package.json',JSON.stringify(p,null,2)+'\n')"
+          echo "Publishing n8n-nodes-pachca@$VERSION"
+
+      - name: Build n8n node
+        if: steps.changes.outputs.changed == 'true'
+        working-directory: integrations/n8n
+        run: |
+          bun run tsc
+          find nodes icons credentials \( -name '*.png' -o -name '*.svg' \) | while read f; do mkdir -p "dist/$(dirname "$f")" && cp "$f" "dist/$f"; done
+
+      - name: Scan community package
+        if: steps.changes.outputs.changed == 'true'
+        working-directory: integrations/n8n
+        run: bun x @n8n/scan-community-package .
+
+      - name: Publish to npm
+        if: steps.changes.outputs.changed == 'true'
+        working-directory: integrations/n8n
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          OUTPUT=$(npm publish --access public --provenance 2>&1) || {
+            CODE=$?
+            if echo "$OUTPUT" | grep -q "E409\|already exists"; then
+              echo "Version ${{ steps.version.outputs.version }} already published, skipping"
+            else
+              echo "$OUTPUT"
+              exit $CODE
+            fi
+          }
+
+      - name: Create GitHub Release
+        if: steps.changes.outputs.changed == 'true'
+        working-directory: integrations/n8n
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          npm pack
+          mkdir n8n-nodes-pachca
+          tar -xzf n8n-nodes-pachca-*.tgz --strip-components=1 -C n8n-nodes-pachca
+          rm n8n-nodes-pachca-*.tgz
+          tar -czf n8n-nodes-pachca.tgz n8n-nodes-pachca
+          gh release create "n8n-v${{ steps.version.outputs.version }}" \
+            n8n-nodes-pachca.tgz \
+            --title "n8n-nodes-pachca v${{ steps.version.outputs.version }}" \
+            --notes "See [CHANGELOG](integrations/n8n/CHANGELOG.md) for details." \
+            --latest