refactor: testing new setup for async-auth quickstarts

Author: jnweiner-auth0

.github/workflows/create-sample-releases.yml

@@ -2,18 +2,14 @@ name: Build and Release Sample Artifacts
 
 on:
   push:
-    branches: [feat/zip-script]
+    branches: [feat/zip-script] # change to 'main' for production
     paths:
-      - '*/*/README.md'
-      - '*/*/*.py'
-      - '*/*/*.js'
-      - '*/*/*.ts'
-      - '*/*/*.jsx'
-      - '*/*/*.tsx'
-      - '*/*/*.json'
-      - '*/*/*.md'
-      - '*/*/*.yml'
-      - '*/*/*.yaml'
+      - '*/*/release-config.yml'
+      - '*/**'                    
+      - '!.github/**'             
+      - '!*.md'                   
+      - '!LICENSE'
+      - '!.gitignore'
   workflow_dispatch:
     inputs:
       force_rebuild:
@@ -44,77 +40,159 @@ jobs:
     - name: Create artifacts directory
       run: mkdir -p artifacts
 
-    - name: Validate repository structure
+    - name: Find and validate release configurations
       run: |
-        echo "🔍 Validating repository structure..."
+        echo "🔍 Finding release configurations..."
         
-        SAMPLE_DIRS=$(find . -maxdepth 2 -type d -path "./*/*" | grep -v ".git" | sort)
+        RELEASE_CONFIGS=$(find . -name "release-config.yml" -not -path "./.git/*" | sort)
         
-        if [ -z "$SAMPLE_DIRS" ]; then
-          echo "❌ No sample directories found!"
+        if [ -z "$RELEASE_CONFIGS" ]; then
+          echo "❌ No release-config.yml files found!"
+          echo "📂 Available directories:"
+          find . -type d -maxdepth 3 | head -20
           exit 1
         fi
         
-        echo "✅ Found sample directories:"
-        echo "$SAMPLE_DIRS"
+        echo "✅ Found release configurations:"
+        echo "$RELEASE_CONFIGS"
         
-    - name: Build quickstart packages
+        # Validate each config file
+        for config_file in $RELEASE_CONFIGS; do
+          echo "📄 Validating: $config_file"
+          
+          # Check if it has required fields and included: true
+          if grep -q "^category:" "$config_file" && grep -q "^framework:" "$config_file"; then
+            INCLUDED=$(grep "^included:" "$config_file" | sed 's/included: *//' | tr -d ' ')
+            if [ "$INCLUDED" = "true" ]; then
+              echo "  ✅ Valid configuration (included: true)"
+            else
+              echo "  ⏭️  Skipping (included: $INCLUDED)"
+            fi
+          else
+            echo "  ❌ Missing required fields (category, framework) in $config_file"
+            exit 1
+          fi
+        done
+
+    - name: Check if changed files are in configured directories
       run: |
-        echo "📦 Building sample packages..."
+        echo "🔍 Checking if changes affect configured quickstarts..."
+        
+        # Get list of directories with release-config.yml
+        CONFIG_DIRS=$(find . -name "release-config.yml" -not -path "./.git/*" -exec dirname {} \; | sort)
+        
+        echo "📂 Directories with release-config.yml:"
+        echo "$CONFIG_DIRS"
+        
+        # If this is a manual trigger, rebuild all
+        if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+          echo "🔄 Manual trigger - will rebuild all configured samples"
+          echo "SHOULD_BUILD=true" >> $GITHUB_ENV
+          exit 0
+        fi
+        
+        # Check if any changed files are in directories with release-config.yml
+        CHANGED_FILES=$(git diff --name-only HEAD~1 HEAD 2>/dev/null || echo "")
+        
+        if [ -z "$CHANGED_FILES" ]; then
+          echo "📝 No changed files detected, building all"
+          echo "SHOULD_BUILD=true" >> $GITHUB_ENV
+          exit 0
+        fi
+        
+        echo "📝 Changed files:"
+        echo "$CHANGED_FILES"
+        
+        SHOULD_BUILD=false
+        
+        for config_dir in $CONFIG_DIRS; do
+          # Remove leading ./
+          clean_dir=$(echo "$config_dir" | sed 's|^\./||')
+          
+          # Check if any changed file is in this directory
+          if echo "$CHANGED_FILES" | grep -q "^$clean_dir/"; then
+            echo "✅ Changes detected in configured directory: $clean_dir"
+            SHOULD_BUILD=true
+            break
+          fi
+        done
+        
+        if [ "$SHOULD_BUILD" = "true" ]; then
+          echo "🔄 Will rebuild artifacts (changes in configured directories)"
+          echo "SHOULD_BUILD=true" >> $GITHUB_ENV
+        else
+          echo "⏭️  No changes in configured directories, skipping build"
+          echo "SHOULD_BUILD=false" >> $GITHUB_ENV
+        fi
 
-        find . -maxdepth 2 -type d -path "./*/*" | grep -v ".git" | while read sample_dir; do
-          if [ -d "$sample_dir" ] && [ -f "$sample_dir/README.md" ]; then
-            CATEGORY=$(basename $(dirname "$sample_dir"))
-            SAMPLE=$(basename "$sample_dir")
-            ZIP_NAME="${CATEGORY}-${SAMPLE}-sample"
-            
-            echo "🔨 Building: $ZIP_NAME"
-            
-            cd "$sample_dir"
-            
-            # Create comprehensive zip with security exclusions
-            zip -r "../../artifacts/${ZIP_NAME}.zip" . \
-              -x "*.git/*" \
-              -x "*/.git/*" \
-              -x "*node_modules/*" \
-              -x "*/__pycache__/*" \
-              -x "*.pyc" \
-              -x "*.pyo" \
-              -x "*dist/*" \
-              -x "*build/*" \
-              -x ".env" \
-              -x "*/.env" \
-              -x "*.env.local" \
-              -x "*.env.production" \
-              -x "*.env.development" \
-              -x "*venv/*" \
-              -x "*.venv/*" \
-              -x "*/.pytest_cache/*" \
-              -x "*/.coverage" \
-              -x "*/coverage/*" \
-              -x "*.log" \
-              -x "*/.DS_Store" \
-              -x "*/Thumbs.db" \
-              -x "*/.idea/*" \
-              -x "*/.vscode/*" \
-              -x "*/temp/*" \
-              -x "*/tmp/*" \
-              -x "*.tmp" \
-              -x "*/.cache/*" \
-              -x "*/.next/*" \
-              -x "*/target/*" \
-              -x "*/.gradle/*" \
-              -x "*/bin/*" \
-              -x "*/obj/*"
-              
+    - name: Build quickstart packages from configs
+      if: env.SHOULD_BUILD == 'true'
+      run: |
+        echo "📦 Building sample packages from configurations..."
+        
+        find . -name "release-config.yml" -not -path "./.git/*" | while read config_file; do
+          sample_dir=$(dirname "$config_file")
+          
+          echo "🔨 Processing: $config_file"
+          cd "$sample_dir"
+          
+          # Check if this sample should be included
+          INCLUDED=$(grep "^included:" release-config.yml | sed 's/included: *//' | tr -d ' ')
+          if [ "$INCLUDED" != "true" ]; then
+            echo "⏭️  Skipping (included: $INCLUDED)"
             cd - > /dev/null
-            
-            if [ -f "artifacts/${ZIP_NAME}.zip" ]; then
-              SIZE=$(du -h "artifacts/${ZIP_NAME}.zip" | cut -f1)
-              echo "✅ Created: ${ZIP_NAME}.zip ($SIZE)"
-            else
-              echo "❌ Failed to create: ${ZIP_NAME}.zip"
-            fi
+            continue
+          fi
+          
+          # Extract configuration using basic shell parsing
+          CATEGORY=$(grep "^category:" release-config.yml | sed 's/category: *"//' | sed 's/"$//' | tr -d ' ')
+          FRAMEWORK=$(grep "^framework:" release-config.yml | sed 's/framework: *"//' | sed 's/"$//' | tr -d ' ')
+          
+          if [ -z "$CATEGORY" ] || [ -z "$FRAMEWORK" ]; then
+            echo "❌ Missing category or framework in $config_file"
+            cd - > /dev/null
+            continue
+          fi
+          
+          # Build zip filename from category and framework
+          ZIP_FILENAME="${CATEGORY}-${FRAMEWORK}-sample"
+          
+          echo "📦 Building: $ZIP_FILENAME.zip"
+          echo "🏷️  Category: $CATEGORY, Framework: $FRAMEWORK"
+          
+          # Start with default exclusions
+          EXCLUDE_ARGS="-x .git/* -x node_modules/* -x __pycache__/* -x *.pyc -x *.pyo"
+          EXCLUDE_ARGS="$EXCLUDE_ARGS -x dist/* -x build/* -x venv/* -x .venv/*"
+          EXCLUDE_ARGS="$EXCLUDE_ARGS -x .pytest_cache/* -x .coverage -x coverage/*"
+          EXCLUDE_ARGS="$EXCLUDE_ARGS -x *.log -x .DS_Store -x Thumbs.db -x .idea/* -x .vscode/*"
+          EXCLUDE_ARGS="$EXCLUDE_ARGS -x temp/* -x tmp/* -x *.tmp -x .cache/* -x .next/*"
+          EXCLUDE_ARGS="$EXCLUDE_ARGS -x target/* -x .gradle/* -x bin/* -x obj/*"
+          EXCLUDE_ARGS="$EXCLUDE_ARGS -x .env -x .env.local -x .env.production -x .env.development"
+          
+          # Add custom exclusions from config
+          if grep -q "^exclude_patterns:" release-config.yml; then
+            echo "📋 Adding custom exclusions from config"
+            while IFS= read -r line; do
+              if echo "$line" | grep -q "^  - "; then
+                pattern=$(echo "$line" | sed 's/^  - "//' | sed 's/"$//' | tr -d ' ')
+                if [ ! -z "$pattern" ]; then
+                  EXCLUDE_ARGS="$EXCLUDE_ARGS -x $pattern"
+                  echo "   Excluding: $pattern"
+                fi
+              fi
+            done < <(grep -A 20 "^exclude_patterns:" release-config.yml)
+          fi
+          
+          # Create the zip
+          eval "zip -r \"../../artifacts/${ZIP_FILENAME}.zip\" . $EXCLUDE_ARGS"
+          
+          cd - > /dev/null
+          
+          if [ -f "artifacts/${ZIP_FILENAME}.zip" ]; then
+            SIZE=$(du -h "artifacts/${ZIP_FILENAME}.zip" | cut -f1)
+            echo "✅ Created: ${ZIP_FILENAME}.zip ($SIZE)"
+          else
+            echo "❌ Failed to create: ${ZIP_FILENAME}.zip"
           fi
         done
         
@@ -128,6 +206,7 @@ jobs:
         ls -la artifacts/ || echo "No artifacts directory or files found"
         
     - name: Security scan artifacts
+      if: env.SHOULD_BUILD == 'true'
       run: |
         echo "🔍 Performing security checks on artifacts..."
         
@@ -163,6 +242,7 @@ jobs:
         EOF
         
     - name: Delete previous 'latest' release
+      if: env.SHOULD_BUILD == 'true'
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: |
@@ -173,6 +253,7 @@ jobs:
         git push origin :refs/tags/latest 2>/dev/null || echo "No previous 'latest' tag found"
     
     - name: Create test release (not latest)
+      if: env.SHOULD_BUILD == 'true'
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: |
@@ -209,7 +290,8 @@ jobs:
         echo ""
         echo "🧪 This is a test release. Official releases coming soon"
 
-    # - name: Create 'latest' release
+    # - name: Create 'latest' release (for production)
+    #   if: env.SHOULD_BUILD == 'true'
     #   env:
     #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     #   run: |
@@ -237,4 +319,10 @@ jobs:
     #         FILENAME=$(basename "$zip_file")
     #         echo "   https://github.com/${{ github.repository }}/releases/latest/download/$FILENAME"
     #       fi
-    #     done
+    #     done
+
+    - name: Skip build notification
+      if: env.SHOULD_BUILD == 'false'
+      run: |
+        echo "⏭️  Build skipped - no changes in directories with release-config.yml files"
+        echo "💡 To force a rebuild, use the manual workflow trigger"

asynchronous-authorization/langchain-fastapi-py/release-config.yml

@@ -0,0 +1,3 @@
+category: "asynchronous-authorization"
+framework: "langchain-fastapi-py"
+included: true

asynchronous-authorization/langchain-next-js/release-config.yml

@@ -0,0 +1,3 @@
+category: "asynchronous-authorization"
+framework: "langchain-next-js"
+included: true

asynchronous-authorization/vercel-ai-next-js/release-config.yml

@@ -0,0 +1,3 @@
+category: "asynchronous-authorization"
+framework: "vercel-ai-next-js"
+included: true

asynchronous-authorization/vercel-ai-node-js/release-config.yml

@@ -0,0 +1,3 @@
+category: "asynchronous-authorization"
+framework: "vercel-ai-node-js"
+included: true