@mherod/get-cookie 4.4.1 → 4.4.2

package/examples/deduplication-demo.sh

@@ -1,110 +0,0 @@
-#!/bin/bash
-
-# Demonstration of the new cookie deduplication feature
-echo "🍪 Cookie Deduplication Feature Demo"
-echo "===================================="
-echo ""
-echo "This demo shows how get-cookie now handles duplicate cookies"
-echo "from Chrome profiles by default, keeping the most valid one."
-echo ""
-
-# Show the problem
-echo "1️⃣ The Problem: Chrome Duplicate Cookies"
-echo "────────────────────────────────────────"
-echo "Chrome can store duplicate cookies from different profiles."
-echo "Let's see what happens with --include-all (old behavior):"
-echo ""
-
-echo "Command: get-cookie user_session github.com --browser chrome --output json --include-all"
-echo ""
-get-cookie user_session github.com --browser chrome --output json --include-all 2>/dev/null | \
-    jq -r '.[] | "  • Value: \(.value[0:20])... (\(.value | length) chars)"'
-echo ""
-
-# Show the solution
-echo "2️⃣ The Solution: Automatic Deduplication (Default)"
-echo "──────────────────────────────────────────────────"
-echo "By default, get-cookie now keeps only the most valid cookie:"
-echo ""
-
-echo "Command: get-cookie user_session github.com --browser chrome --output json"
-echo ""
-get-cookie user_session github.com --browser chrome --output json 2>/dev/null | \
-    jq -r '.[] | "  • Value: \(.value[0:20])... (\(.value | length) chars)"'
-echo ""
-
-# Demonstrate the render difference
-echo "3️⃣ Impact on --render Output"
-echo "───────────────────────────"
-echo ""
-
-echo "With --include-all (all duplicates):"
-RENDER_ALL=$(get-cookie user_session github.com --browser chrome --render --include-all 2>/dev/null)
-echo "  ${RENDER_ALL:0:60}..."
-echo "  Length: $(echo "$RENDER_ALL" | wc -c) chars"
-echo ""
-
-echo "Default (deduplicated):"
-RENDER_DEDUP=$(get-cookie user_session github.com --browser chrome --render 2>/dev/null)
-echo "  $RENDER_DEDUP"
-echo "  Length: $(echo "$RENDER_DEDUP" | wc -c) chars"
-echo ""
-
-# Show how it works with curl
-echo "4️⃣ Using with curl"
-echo "────────────────"
-echo "The deduplication ensures curl gets the valid cookie:"
-echo ""
-
-echo "Command: curl -H \"Cookie: \$(get-cookie --url <URL> --browser chrome --render)\" <URL>"
-echo ""
-echo "Example for GitHub:"
-COOKIES=$(get-cookie --url https://github.com --browser chrome --render 2>/dev/null)
-echo "  Cookie count: $(echo "$COOKIES" | grep -o ';' | wc -l | xargs expr 1 +)"
-echo "  user_session value length: $(echo "$COOKIES" | grep -o 'user_session=[^;]*' | cut -d'=' -f2 | wc -c) chars"
-echo ""
-
-# Show all duplicates
-echo "5️⃣ Viewing All Duplicates"
-echo "───────────────────────"
-echo "To see all duplicate cookies (for debugging), use --include-all:"
-echo ""
-
-echo "Command: get-cookie % github.com --browser chrome --output json --include-all"
-echo ""
-echo "Duplicate cookie names found:"
-get-cookie % github.com --browser chrome --output json --include-all 2>/dev/null | \
-    jq -r '[.[] | .name] | group_by(.) | map(select(length > 1)) | map(.[0]) | .[]' | \
-    sort | uniq | while read name; do
-        COUNT=$(get-cookie "$name" github.com --browser chrome --output json --include-all 2>/dev/null | jq 'length')
-        if [ "$COUNT" -gt 1 ]; then
-            echo "  • $name: $COUNT copies"
-        fi
-    done
-echo ""
-
-# Summary
-echo "📊 Summary"
-echo "────────"
-echo ""
-
-# Count cookies with and without deduplication
-TOTAL_ALL=$(get-cookie % github.com --browser chrome --output json --include-all 2>/dev/null | jq 'length')
-TOTAL_DEDUP=$(get-cookie % github.com --browser chrome --output json 2>/dev/null | jq 'length')
-REMOVED=$((TOTAL_ALL - TOTAL_DEDUP))
-
-echo "Chrome cookies for github.com:"
-echo "  • With --include-all: $TOTAL_ALL cookies"
-echo "  • Default (deduplicated): $TOTAL_DEDUP cookies"
-echo "  • Duplicates removed: $REMOVED"
-echo ""
-
-echo "💡 Key Points:"
-echo "────────────"
-echo "• Deduplication is ON by default (keeps longest/newest cookie)"
-echo "• Use --include-all to see all duplicates"
-echo "• Combines with --include-expired for complete control"
-echo "• Solves the Chrome \"truncated cookie\" problem"
-echo ""
-
-echo "✅ The deduplication feature ensures you get valid cookies for authentication!"

package/examples/final-chrome-demo.sh

@@ -1,115 +0,0 @@
-#!/bin/bash
-
-# Final demonstration of Chrome cookie extraction with deduplication
-echo "🍪 get-cookie Chrome Integration Demo"
-echo "====================================="
-echo ""
-
-echo "✨ New Features Implemented:"
-echo "──────────────────────────"
-echo "1. Automatic cookie deduplication (keeps longest/most valid)"
-echo "2. --include-all flag to see all duplicates"
-echo "3. --include-expired flag to include expired cookies"
-echo ""
-
-# Show the improved Chrome cookie extraction
-echo "📊 Chrome Cookie Extraction:"
-echo "──────────────────────────"
-echo ""
-
-echo "Default behavior (deduplicated, non-expired only):"
-echo "$ get-cookie --url https://github.com --browser chrome --render"
-echo ""
-COOKIES=$(get-cookie --url https://github.com --browser chrome --render 2>/dev/null)
-echo "${COOKIES:0:100}..."
-echo "Total length: $(echo "$COOKIES" | wc -c) chars"
-echo ""
-
-# Show the cookie stats
-echo "Cookie Statistics:"
-DEFAULT_COUNT=$(get-cookie --url https://github.com --browser chrome --output json 2>/dev/null | jq 'length')
-ALL_COUNT=$(get-cookie --url https://github.com --browser chrome --output json --include-all 2>/dev/null | jq 'length')
-echo "  • Deduplicated cookies: $DEFAULT_COUNT"
-echo "  • All cookies (--include-all): $ALL_COUNT"
-echo "  • Duplicates removed: $((ALL_COUNT - DEFAULT_COUNT))"
-echo ""
-
-# Demonstrate the key improvement
-echo "🔑 Key Improvement: Session Cookie Handling"
-echo "──────────────────────────────────────────"
-echo ""
-echo "Problem: Chrome stores duplicate session cookies"
-echo "  • Invalid truncated: 'AJW' (3 chars)"
-echo "  • Valid full session: 'SgOohLA29269kO...' (48 chars)"
-echo ""
-echo "Solution: Automatic deduplication keeps the valid one:"
-SESSION=$(get-cookie user_session github.com --browser chrome --output json 2>/dev/null | jq -r '.[0].value')
-echo "  • Selected: ${SESSION:0:20}... (${#SESSION} chars) ✅"
-echo ""
-
-# Show practical usage patterns
-echo "💻 Practical Usage Patterns:"
-echo "──────────────────────────"
-echo ""
-
-echo "1. Simple cookie extraction for curl:"
-echo '   curl -H "Cookie: $(get-cookie --url <URL> --browser chrome --render)" <URL>'
-echo ""
-
-echo "2. JSON output for precise control:"
-echo '   get-cookie --url <URL> --browser chrome --output json | jq ...'
-echo ""
-
-echo "3. Debug duplicate cookies:"
-echo '   get-cookie --url <URL> --browser chrome --output json --include-all'
-echo ""
-
-echo "4. Include expired cookies (if needed):"
-echo '   get-cookie --url <URL> --browser chrome --render --include-expired'
-echo ""
-
-# Test with a simpler site
-echo "🧪 Testing with httpbin.org:"
-echo "──────────────────────────"
-echo ""
-
-# Set a test cookie in Chrome (this would need to be done manually)
-echo "Setting a test cookie and retrieving it:"
-echo '$ curl -c - "https://httpbin.org/cookies/set?test_cookie=hello_world"'
-echo ""
-
-# Try to get any httpbin cookies
-HTTPBIN_COOKIES=$(get-cookie % httpbin.org --browser chrome --output json 2>/dev/null | jq 'length')
-if [ "$HTTPBIN_COOKIES" -gt 0 ]; then
-    echo "Found $HTTPBIN_COOKIES httpbin.org cookies in Chrome"
-    get-cookie % httpbin.org --browser chrome --render
-else
-    echo "No httpbin.org cookies found (visit httpbin.org in Chrome to set some)"
-fi
-echo ""
-
-# Summary
-echo "📈 Performance Improvements:"
-echo "─────────────────────────"
-echo "• Eliminates duplicate cookies automatically"
-echo "• Filters expired cookies by default"
-echo "• Prioritizes valid cookies (longer values)"
-echo "• Backwards compatible with --include-all flag"
-echo ""
-
-echo "🔒 Note on GitHub Authentication:"
-echo "────────────────────────────────"
-echo "GitHub uses additional security measures beyond cookies:"
-echo "• IP address verification"
-echo "• User-Agent fingerprinting"
-echo "• Session binding to browser instance"
-echo "• CORS and referer checking"
-echo ""
-echo "For GitHub API access, use:"
-echo "• GitHub CLI: gh auth login"
-echo "• Personal Access Tokens"
-echo "• OAuth apps"
-echo ""
-
-echo "✅ Chrome cookie extraction is working perfectly!"
-echo "   The deduplication ensures you get valid, usable cookies."

package/examples/github-api.sh

@@ -1,101 +0,0 @@
-#!/bin/bash
-
-# Real-world example: Using get-cookie to access GitHub's authenticated endpoints
-# This demonstrates how browser cookies can be used for API automation
-
-echo "🔐 GitHub API Authentication with get-cookie"
-echo "============================================"
-
-# Get all relevant GitHub cookies using --render
-echo -e "\nExtracting GitHub cookies..."
-COOKIES=$(get-cookie % github.com --render 2>/dev/null | grep -E "(user_session|dotcom_user|__Host)" | paste -sd '; ')
-
-if [ -z "$COOKIES" ]; then
-    echo "❌ No GitHub cookies found. Please log into GitHub in your browser."
-    exit 1
-fi
-
-echo "✅ Found GitHub cookies"
-echo "   Cookie count: $(echo "$COOKIES" | grep -o ';' | wc -l | xargs expr 1 +)"
-
-# Test authentication with various GitHub endpoints
-echo -e "\n📊 Testing GitHub API endpoints:\n"
-
-# 1. User profile (public API, but returns more data when authenticated)
-echo "1. Fetching user profile..."
-USER_DATA=$(curl -s -H "Cookie: $COOKIES" https://api.github.com/user)
-LOGIN=$(echo "$USER_DATA" | jq -r '.login // empty')
-if [ -n "$LOGIN" ]; then
-    echo "   ✅ Authenticated as: @$LOGIN"
-    echo "   • Name: $(echo "$USER_DATA" | jq -r '.name // "N/A"')"
-    echo "   • Public repos: $(echo "$USER_DATA" | jq -r '.public_repos // 0')"
-    echo "   • Followers: $(echo "$USER_DATA" | jq -r '.followers // 0')"
-else
-    echo "   ⚠️ API authentication failed (cookies may not work for API)"
-fi
-
-# 2. Check notifications (requires authentication)
-echo -e "\n2. Checking notifications..."
-NOTIFICATIONS=$(curl -s -H "Cookie: $COOKIES" \
-    -H "Accept: application/vnd.github.v3+json" \
-    "https://api.github.com/notifications" | jq '. | length')
-if [ "$NOTIFICATIONS" != "null" ]; then
-    echo "   📬 Unread notifications: $NOTIFICATIONS"
-else
-    echo "   ⚠️ Could not fetch notifications"
-fi
-
-# 3. List private repos (if any)
-echo -e "\n3. Checking private repositories..."
-PRIVATE_REPOS=$(curl -s -H "Cookie: $COOKIES" \
-    "https://api.github.com/user/repos?type=private" | jq '. | length')
-if [ "$PRIVATE_REPOS" != "null" ] && [ "$PRIVATE_REPOS" != "0" ]; then
-    echo "   🔒 Private repositories: $PRIVATE_REPOS"
-else
-    echo "   ℹ️ No private repositories accessible"
-fi
-
-# 4. Recent activity
-echo -e "\n4. Fetching recent activity..."
-EVENTS=$(curl -s -H "Cookie: $COOKIES" \
-    "https://api.github.com/users/$LOGIN/events?per_page=5" | jq -r '.[] | "\(.type) in \(.repo.name)"' 2>/dev/null | head -5)
-if [ -n "$EVENTS" ]; then
-    echo "   Recent activity:"
-    echo "$EVENTS" | while read event; do
-        echo "   • $event"
-    done
-else
-    echo "   ⚠️ Could not fetch activity"
-fi
-
-# Practical example: Create a gist
-echo -e "\n💡 Example: Creating a gist with authentication"
-echo "──────────────────────────────────────────────"
-cat << 'EOF'
-curl -X POST \
-  -H "Cookie: $(get-cookie % github.com --render | grep -E 'user_session|__Host' | paste -sd '; ')" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "description": "Created via get-cookie + curl",
-    "public": false,
-    "files": {
-      "test.md": {
-        "content": "# Hello from get-cookie!\nThis gist was created using browser cookies."
-      }
-    }
-  }' \
-  https://api.github.com/gists
-EOF
-
-echo -e "\n🔍 Debugging tip:"
-echo "──────────────────"
-echo "If authentication fails, GitHub cookies might not work with the API."
-echo "GitHub's API primarily uses OAuth tokens, not browser session cookies."
-echo ""
-echo "To see what cookies you have:"
-echo "  get-cookie % github.com --dump"
-echo ""
-echo "To get just the cookie values:"
-echo "  get-cookie user_session github.com --render"
-echo ""
-echo "✅ Script complete!"

package/examples/github-private-access.sh

@@ -1,118 +0,0 @@
-#!/bin/bash
-
-# Accessing GitHub private content with browser cookies
-echo "🔓 GitHub Private Repository Access with get-cookie"
-echo "=================================================="
-echo ""
-
-# Get the full session cookie (not truncated ones)
-echo "Extracting valid GitHub session cookies..."
-FULL_SESSION=$(get-cookie user_session github.com --output json 2>/dev/null | jq -r '.[] | select(.value | length > 10) | .value' | head -1)
-
-if [ -z "$FULL_SESSION" ]; then
-    echo "❌ No valid GitHub session found. Please log into GitHub in Chrome."
-    exit 1
-fi
-
-echo "✅ Found valid session cookie (${#FULL_SESSION} characters)"
-echo ""
-
-# Build the cookie header with both required cookies
-COOKIE_HEADER="user_session=$FULL_SESSION; __Host-user_session_same_site=$FULL_SESSION"
-
-# Get username
-USERNAME=$(get-cookie dotcom_user github.com --output json 2>/dev/null | jq -r '.[0].value' | cut -d';' -f1)
-echo "👤 Logged in as: $USERNAME"
-echo ""
-
-echo "📊 Repository Statistics:"
-echo "────────────────────────"
-
-# Count repositories
-REPOS_HTML=$(curl -s -L \
-    -H "Cookie: $COOKIE_HEADER" \
-    -H "User-Agent: Mozilla/5.0" \
-    "https://github.com/$USERNAME?tab=repositories")
-
-PUBLIC_COUNT=$(echo "$REPOS_HTML" | grep -o '>Public<' | wc -l | xargs)
-PRIVATE_COUNT=$(echo "$REPOS_HTML" | grep -o '>Private<' | wc -l | xargs)
-
-echo "• Public repositories: $PUBLIC_COUNT"
-echo "• Private repositories: $PRIVATE_COUNT"
-echo "• Total: $((PUBLIC_COUNT + PRIVATE_COUNT))"
-echo ""
-
-echo "🔒 Private Repositories (first 5):"
-echo "──────────────────────────────────"
-
-# Extract private repo names
-echo "$REPOS_HTML" | grep -B3 '>Private<' | grep 'itemprop="name codeRepository"' | head -5 | while read line; do
-    REPO_NAME=$(echo "$line" | sed -n 's/.*href="[^"]*\/\([^"]*\)".*/\1/p')
-    if [ -n "$REPO_NAME" ]; then
-        echo "• $REPO_NAME"
-        
-        # Get repo details
-        REPO_PAGE=$(curl -s -L \
-            -H "Cookie: $COOKIE_HEADER" \
-            -H "User-Agent: Mozilla/5.0" \
-            "https://github.com/$USERNAME/$REPO_NAME")
-        
-        # Extract language if available
-        LANGUAGE=$(echo "$REPO_PAGE" | grep -o 'programmingLanguage">[^<]*' | head -1 | cut -d'>' -f2)
-        [ -n "$LANGUAGE" ] && echo "  Language: $LANGUAGE"
-        
-        # Count files
-        FILE_COUNT=$(echo "$REPO_PAGE" | grep -o 'js-navigation-open Link--primary' | wc -l | xargs)
-        [ "$FILE_COUNT" -gt 0 ] && echo "  Files/Folders visible: $FILE_COUNT"
-    fi
-done
-
-echo ""
-echo "🔑 Testing Access Levels:"
-echo "────────────────────────"
-
-# Test various authenticated endpoints
-test_access() {
-    local name=$1
-    local url=$2
-    echo -n "• $name: "
-    
-    CODE=$(curl -s -o /dev/null -w "%{http_code}" \
-        -H "Cookie: $COOKIE_HEADER" \
-        -H "User-Agent: Mozilla/5.0" \
-        "$url")
-    
-    if [ "$CODE" = "200" ]; then
-        echo "✅ Full access"
-    elif [ "$CODE" = "404" ]; then
-        echo "❌ Not found"
-    else
-        echo "⚠️  Limited access (HTTP $CODE)"
-    fi
-}
-
-test_access "Settings" "https://github.com/settings/profile"
-test_access "SSH Keys" "https://github.com/settings/keys"
-test_access "Security" "https://github.com/settings/security"
-test_access "Billing" "https://github.com/settings/billing"
-test_access "New Repository" "https://github.com/new"
-
-echo ""
-echo "💡 Practical Examples:"
-echo "────────────────────"
-echo ""
-echo "# Clone a private repository (using gh CLI):"
-echo "gh repo clone $USERNAME/<private-repo-name>"
-echo ""
-echo "# Download a file from a private repo:"
-echo "curl -H \"Cookie: user_session=\$SESSION; __Host-user_session_same_site=\$SESSION\" \\"
-echo "     https://github.com/$USERNAME/<private-repo>/raw/main/file.txt"
-echo ""
-echo "# Access private gist:"
-echo "curl -H \"Cookie: user_session=\$SESSION; __Host-user_session_same_site=\$SESSION\" \\"
-echo "     https://gist.github.com/$USERNAME/<gist-id>"
-echo ""
-echo "⚠️  Note: While we can VIEW private repos via the web interface,"
-echo "   cloning still requires proper Git authentication (SSH key or token)."
-echo ""
-echo "✅ Authentication successful! You have full web access to your private repos."

package/examples/list-profiles-demo.sh

@@ -1,120 +0,0 @@
-#!/bin/bash
-
-# Demonstration of the --list-profiles feature
-echo "🍪 Profile Listing Feature Demo"
-echo "==============================="
-echo ""
-
-echo "The new --list-profiles option helps you discover available browser profiles"
-echo "before using them with the --profile option."
-echo ""
-
-# Basic usage
-echo "📋 Basic Usage:"
-echo "─────────────"
-echo "$ get-cookie --browser chrome --list-profiles"
-echo ""
-get-cookie --browser chrome --list-profiles
-echo ""
-
-# Show how it integrates with profile selection
-echo "🔗 Integration with Profile Selection:"
-echo "────────────────────────────────────"
-echo ""
-echo "Step 1: List available profiles"
-echo "$ get-cookie --browser chrome --list-profiles"
-echo ""
-echo "Step 2: Use a specific profile name from the list"
-echo "$ get-cookie --url https://github.com --browser chrome --profile \"plugg.in\" --render"
-echo ""
-
-# Demonstrate actual usage
-echo "Example: Getting cookies from a specific profile"
-echo ""
-PROFILE_NAME="plugg.in"
-if get-cookie --browser chrome --list-profiles 2>/dev/null | grep -q "$PROFILE_NAME"; then
-    echo "✓ Profile '$PROFILE_NAME' found"
-    echo ""
-    echo "Getting GitHub session from '$PROFILE_NAME' profile:"
-    SESSION=$(get-cookie user_session github.com --browser chrome --profile "$PROFILE_NAME" --render 2>/dev/null)
-    if [ -n "$SESSION" ]; then
-        VALUE=$(echo "$SESSION" | cut -d'=' -f2)
-        echo "  user_session=${VALUE:0:20}... (${#VALUE} chars)"
-    else
-        echo "  No session cookie found"
-    fi
-else
-    echo "Profile '$PROFILE_NAME' not found"
-fi
-echo ""
-
-# Show error handling
-echo "⚠️  Error Handling:"
-echo "────────────────"
-echo ""
-echo "Without --browser flag:"
-echo "$ get-cookie --list-profiles"
-get-cookie --list-profiles 2>&1 | head -2
-echo ""
-
-echo "With unsupported browser:"
-echo "$ get-cookie --browser safari --list-profiles"
-get-cookie --browser safari --list-profiles 2>&1
-echo ""
-
-# Show all supported browsers
-echo "🌐 Supported Browsers:"
-echo "───────────────────"
-echo ""
-echo "Chromium-based browsers with profile support:"
-echo "  • chrome    - Google Chrome"
-echo "  • edge      - Microsoft Edge"
-echo "  • arc       - Arc Browser"
-echo "  • opera     - Opera"
-echo "  • opera-gx  - Opera GX"
-echo ""
-echo "Other browsers:"
-echo "  • firefox   - Profile listing coming soon"
-echo "  • safari    - No profile support (uses system keychain)"
-echo ""
-
-# Practical workflow
-echo "💼 Practical Workflow:"
-echo "───────────────────"
-echo ""
-cat << 'EOF'
-# 1. Check which profiles are available
-get-cookie --browser chrome --list-profiles
-
-# 2. Choose the profile with the right session
-#    (e.g., "Work" for company repos, "Personal" for personal)
-
-# 3. Extract cookies from that specific profile
-COOKIES=$(get-cookie --url https://github.com \
-          --browser chrome \
-          --profile "Work" \
-          --render)
-
-# 4. Use with curl for authenticated requests
-curl -H "Cookie: $COOKIES" https://github.com/company/private-repo
-EOF
-echo ""
-
-# Show JSON output option
-echo "📊 JSON Output Option:"
-echo "──────────────────"
-echo ""
-echo "For scripting, combine with JSON output:"
-echo '$ get-cookie --url https://example.com --browser chrome --profile "Work" --output json | jq ...'
-echo ""
-
-# Summary
-echo "✨ Summary:"
-echo "─────────"
-echo "• Use --list-profiles to discover available profiles"
-echo "• Profile names are shown with their directory mappings"
-echo "• User email is displayed when available"
-echo "• Works with all Chromium-based browsers"
-echo "• Essential for managing multiple logged-in sessions"
-echo ""
-echo "✅ The --list-profiles feature makes profile selection easy and discoverable!"