@mherod/get-cookie 4.4.1 → 4.4.3

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@mherod/get-cookie",
-  "version": "4.4.1",
+  "version": "4.4.3",
   "description": "Node.js module for querying cookies from Chrome, Firefox, and Safari browsers",
-  "packageManager": "pnpm@9.15.2",
   "type": "module",
   "source": "src/index.ts",
   "bin": {
@@ -25,42 +24,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "clean": "rm -rf dist",
-    "build:lib": "tsup --config tsup.lib.ts",
-    "build:cli": "tsup --config tsup.cli.ts",
-    "build": "pnpm run build:lib && pnpm run build:cli",
-    "test": "jest",
-    "type-check": "tsc --noEmit --skipLibCheck",
-    "lint": "biome check --diagnostic-level=error .",
-    "lint:eslint": "eslint --config eslint.config.js \"src/**/*.{ts,js}\"",
-    "lint:all": "pnpm run lint && pnpm run lint:eslint",
-    "lint:fix": "biome check --write --unsafe . && eslint --config eslint.config.js --fix \"src/**/*.{ts,js}\"",
-    "lint:staged": "biome check --staged --write .",
-    "format": "biome format --write .",
-    "format:check": "biome check --diagnostic-level=error .",
-    "validate": "pnpm run type-check && pnpm run lint && pnpm run test && pnpm run check-links && pnpm run format:check",
-    "audit": "pnpm audit --audit-level moderate",
-    "audit:fix": "pnpm audit --fix",
-    "outdated": "pnpm outdated",
-    "prepack": "pnpm run validate",
-    "prepublishOnly": "pnpm run clean && pnpm run validate && pnpm run build",
-    "dev": "tsc -w -p tsconfig.json & tsc-alias -w -p tsconfig.json",
-    "read-github": "NODE_OPTIONS=\"-r tsconfig-paths/register\" tsx scripts/read-github-cookies.ts",
-    "prepare": "husky install",
-    "docs": "typedoc && ./scripts/fix-typedoc.sh && vitepress build docs",
-    "docs:dev": "vitepress dev docs",
-    "docs:preview": "vitepress preview docs",
-    "check-links": "./scripts/check-vitepress-links.sh",
-    "deps": "madge --ts-config ./tsconfig.json src/index.ts",
-    "deps:circular": "madge --circular --ts-config ./tsconfig.json src/",
-    "deps:orphans": "madge --orphans --ts-config ./tsconfig.json src/",
-    "deps:text": "depcruise src --include-only \"^src\" --output-type text",
-    "deps:html": "depcruise src --include-only \"^src\" --output-type html --output-to dependency-report.html",
-    "deps:validate": "depcruise src --config .dependency-cruiser.js"
-  },
   "engines": {
-    "node": "^20.0.0 || ^22.0.0 || ^24.0.0"
+    "node": "^20.0.0 || ^22.0.0 || ^24.0.0 || ^25.0.0"
   },
   "keywords": [],
   "author": "Matthew Herod",
@@ -72,8 +37,8 @@
     "destr": "^2.0.5",
     "dotenv": "17.2.3",
     "fast-glob": "^3.3.3",
-    "jsonwebtoken": "^9.0.2",
-    "lodash-es": "^4.17.21",
+    "jsonwebtoken": "^9.0.3",
+    "lodash-es": "^4.17.23",
     "minimist": "^1.2.8",
     "tsconfig-paths": "^4.2.0",
     "zod": "^4.1.11"
@@ -119,11 +84,6 @@
     "typescript": "^5.9.2",
     "vitepress": "^1.6.4"
   },
-  "pnpm": {
-    "overrides": {
-      "esbuild": "^0.25.0"
-    }
-  },
   "lint-staged": {
     "*.{js,ts}": [
       "biome check --write --no-errors-on-unmatched"
@@ -135,5 +95,36 @@
       "biome format --write --no-errors-on-unmatched",
       "./scripts/check-vitepress-links.sh"
     ]
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build:lib": "tsup --config tsup.lib.ts",
+    "build:cli": "tsup --config tsup.cli.ts",
+    "build": "pnpm run build:lib && pnpm run build:cli",
+    "test": "jest",
+    "type-check": "tsc --noEmit --skipLibCheck",
+    "lint": "biome check --diagnostic-level=error .",
+    "lint:eslint": "eslint --config eslint.config.js \"src/**/*.{ts,js}\"",
+    "lint:all": "pnpm run lint && pnpm run lint:eslint",
+    "lint:fix": "biome check --write --unsafe . && eslint --config eslint.config.js --fix \"src/**/*.{ts,js}\"",
+    "lint:staged": "biome check --staged --write .",
+    "format": "biome format --write .",
+    "format:check": "biome check --diagnostic-level=error .",
+    "validate": "pnpm run type-check && pnpm run lint && pnpm run test && pnpm run check-links && pnpm run format:check",
+    "audit": "pnpm audit --audit-level moderate",
+    "audit:fix": "pnpm audit --fix",
+    "outdated": "pnpm outdated",
+    "dev": "tsc -w -p tsconfig.json & tsc-alias -w -p tsconfig.json",
+    "read-github": "NODE_OPTIONS=\"-r tsconfig-paths/register\" tsx scripts/read-github-cookies.ts",
+    "docs": "typedoc && ./scripts/fix-typedoc.sh && vitepress build docs",
+    "docs:dev": "vitepress dev docs",
+    "docs:preview": "vitepress preview docs",
+    "check-links": "./scripts/check-vitepress-links.sh",
+    "deps": "madge --ts-config ./tsconfig.json src/index.ts",
+    "deps:circular": "madge --circular --ts-config ./tsconfig.json src/",
+    "deps:orphans": "madge --orphans --ts-config ./tsconfig.json src/",
+    "deps:text": "depcruise src --include-only \"^src\" --output-type text",
+    "deps:html": "depcruise src --include-only \"^src\" --output-type html --output-to dependency-report.html",
+    "deps:validate": "depcruise src --config .dependency-cruiser.js"
   }
-}
+}

package/tsup.cli.ts

@@ -29,6 +29,7 @@ export default defineConfig({
   bundle: true,
   tsconfig: "./tsconfig.cli.json",
   noExternal: ["lodash-es"],
+  external: ["bun:sqlite"],
   treeshake: true,
   splitting: false,
   skipNodeModulesBundle: true,

package/tsup.lib.ts

@@ -26,7 +26,15 @@ export default defineConfig({
   platform: "node",
   bundle: true,
   tsconfig: "./tsconfig.tsup.json",
-  external: ["fs", "path", "crypto", "os", "child_process", "lodash-es"],
+  external: [
+    "fs",
+    "path",
+    "crypto",
+    "os",
+    "child_process",
+    "lodash-es",
+    "bun:sqlite",
+  ],
   treeshake: true,
   splitting: false,
   skipNodeModulesBundle: true,

package/examples/chrome-cookies-demo.sh

@@ -1,117 +0,0 @@
-#!/bin/bash
-
-# Chrome-specific cookie extraction demo
-echo "🍪 Chrome Cookie Extraction with get-cookie"
-echo "==========================================="
-echo ""
-
-# Basic Chrome cookie extraction
-echo "1️⃣ Basic Chrome cookie extraction:"
-echo "─────────────────────────────────"
-echo "Command: get-cookie --url https://github.com --browser chrome --render"
-echo ""
-COOKIES=$(get-cookie --url https://github.com --browser chrome --render 2>/dev/null | head -c 100)
-echo "Output (truncated): $COOKIES..."
-echo ""
-
-# JSON output for debugging
-echo "2️⃣ Chrome cookies in JSON format:"
-echo "────────────────────────────────"
-echo "Command: get-cookie --url https://github.com --browser chrome --output json"
-echo ""
-get-cookie --url https://github.com --browser chrome --output json 2>/dev/null | jq '.[:2]'
-echo ""
-
-# Filtering duplicates
-echo "3️⃣ Handling duplicate cookies:"
-echo "─────────────────────────────"
-echo "Chrome may have duplicate cookies from different profiles."
-echo ""
-echo "Session cookies found:"
-get-cookie --url https://github.com --browser chrome --output json 2>/dev/null | \
-    jq -r '.[] | select(.name == "user_session") | "  • \(.value[0:20])... (\(.value | length) chars)"'
-echo ""
-
-# Smart filtering
-echo "4️⃣ Smart cookie filtering (recommended):"
-echo "───────────────────────────────────────"
-echo "Filter to get the longest (most likely valid) cookie value:"
-echo ""
-cat << 'EOF'
-VALID_SESSION=$(get-cookie --url https://github.com --browser chrome --output json | \
-    jq -r '.[] | select(.name == "user_session" and (.value | length) > 20) | .value' | \
-    head -1)
-EOF
-echo ""
-
-# Using with curl
-echo "5️⃣ Using Chrome cookies with curl:"
-echo "────────────────────────────────"
-echo "Simple approach (may fail with duplicates):"
-echo 'curl -H "Cookie: $(get-cookie --url <URL> --browser chrome --render)" <URL>'
-echo ""
-echo "Robust approach (with filtering):"
-cat << 'EOF'
-# Get deduplicated cookies (longest value wins)
-COOKIES=$(get-cookie --url <URL> --browser chrome --output json | \
-    jq -r 'group_by(.name) | map(max_by(.value | length)) | 
-    .[] | "\(.name)=\(.value)"' | tr '\n' ';')
-
-curl -H "Cookie: $COOKIES" <URL>
-EOF
-echo ""
-
-# Testing authentication
-echo "6️⃣ Testing GitHub authentication with Chrome cookies:"
-echo "───────────────────────────────────────────────────"
-COOKIES=$(get-cookie --url https://github.com --browser chrome --output json 2>/dev/null | \
-    jq -r 'group_by(.name) | map(max_by(.value | length)) | .[] | "\(.name)=\(.value)"' | tr '\n' ';')
-
-echo -n "Testing with deduplicated cookies: "
-HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
-    -H "Cookie: $COOKIES" \
-    -H "User-Agent: Mozilla/5.0" \
-    "https://github.com/settings/profile")
-
-if [ "$HTTP_CODE" = "200" ]; then
-    echo "✅ Success (HTTP 200)"
-elif [ "$HTTP_CODE" = "302" ]; then
-    echo "❌ Redirected to login (HTTP 302)"
-else
-    echo "⚠️  HTTP $HTTP_CODE"
-fi
-echo ""
-
-# Check cookie counts
-echo "7️⃣ Cookie statistics:"
-echo "──────────────────"
-TOTAL=$(get-cookie --url https://github.com --browser chrome --output json 2>/dev/null | jq 'length')
-UNIQUE=$(get-cookie --url https://github.com --browser chrome --output json 2>/dev/null | jq '[.[] | .name] | unique | length')
-echo "• Total cookies: $TOTAL"
-echo "• Unique cookie names: $UNIQUE"
-echo "• Duplicates: $((TOTAL - UNIQUE))"
-echo ""
-
-# Expired cookie filtering
-echo "8️⃣ Expired cookie filtering:"
-echo "──────────────────────────"
-WITHOUT=$(get-cookie --url https://github.com --browser chrome --output json 2>/dev/null | jq 'length')
-WITH=$(get-cookie --url https://github.com --browser chrome --output json --include-expired 2>/dev/null | jq 'length')
-echo "• Without --include-expired: $WITHOUT cookies"
-echo "• With --include-expired: $WITH cookies"
-if [ "$WITH" -gt "$WITHOUT" ]; then
-    echo "• ✅ Filtered out $((WITH - WITHOUT)) expired cookies"
-else
-    echo "• ℹ️  No expired cookies found"
-fi
-echo ""
-
-echo "💡 Key Insights:"
-echo "──────────────"
-echo "• Chrome may store duplicate cookies from different profiles"
-echo "• The --render flag outputs all cookies, including duplicates"
-echo "• For authentication, deduplicate by taking the longest value"
-echo "• Expired cookies are filtered by default (use --include-expired to see all)"
-echo "• Use JSON output + jq for precise cookie control"
-echo ""
-echo "✅ Chrome cookie extraction complete!"

package/examples/chrome-profile-demo.sh

@@ -1,126 +0,0 @@
-#!/bin/bash
-
-# Chrome Profile Selection Demo
-echo "🍪 Chrome Profile Selection with get-cookie"
-echo "==========================================="
-echo ""
-echo "The new --profile option allows targeting specific Chrome profiles by name."
-echo ""
-
-# List available Chrome profiles
-echo "📋 Available Chrome Profiles:"
-echo "──────────────────────────"
-if [ -f ~/Library/Application\ Support/Google/Chrome/Local\ State ]; then
-    cat ~/Library/Application\ Support/Google/Chrome/Local\ State | \
-        jq -r '.profile.info_cache | to_entries | .[] | "  • \(.value.name) (directory: \(.key))"'
-else
-    echo "  Chrome Local State file not found"
-fi
-echo ""
-
-# Demonstrate profile-specific extraction
-echo "🎯 Profile-Specific Cookie Extraction:"
-echo "────────────────────────────────────"
-echo ""
-
-echo "1️⃣ Extract from a specific profile by name:"
-echo "   Command: get-cookie --url https://github.com --browser chrome --profile \"plugg.in\" --render"
-echo ""
-COOKIES=$(get-cookie --url https://github.com --browser chrome --profile "plugg.in" --render 2>/dev/null | head -c 80)
-echo "   Output: $COOKIES..."
-echo ""
-
-echo "2️⃣ Compare different profiles for the same cookie:"
-echo ""
-echo "   Default/Personal profile:"
-echo "   $ get-cookie user_session github.com --browser chrome --profile \"Personal\" --render"
-PERSONAL=$(get-cookie user_session github.com --browser chrome --profile "Personal" --render 2>/dev/null)
-if [ -n "$PERSONAL" ]; then
-    VALUE=$(echo "$PERSONAL" | cut -d'=' -f2)
-    echo "   Result: user_session=${VALUE:0:20}... (${#VALUE} chars)"
-else
-    echo "   Result: No user_session cookie found"
-fi
-echo ""
-
-echo "   Profile 9/plugg.in profile:"
-echo "   $ get-cookie user_session github.com --browser chrome --profile \"plugg.in\" --render"
-PLUGIN=$(get-cookie user_session github.com --browser chrome --profile "plugg.in" --render 2>/dev/null)
-if [ -n "$PLUGIN" ]; then
-    VALUE=$(echo "$PLUGIN" | cut -d'=' -f2)
-    echo "   Result: user_session=${VALUE:0:20}... (${#VALUE} chars)"
-else
-    echo "   Result: No user_session cookie found"
-fi
-echo ""
-
-# Show the benefit
-echo "💡 Benefits of Profile Selection:"
-echo "───────────────────────────────"
-echo "• Avoid cookie conflicts between profiles"
-echo "• Target the correct logged-in session"
-echo "• No need for deduplication when using specific profile"
-echo "• Faster queries (only searches one profile)"
-echo ""
-
-# Practical curl example
-echo "🔧 Practical Example with curl:"
-echo "─────────────────────────────"
-echo ""
-echo "Use the correct profile for authenticated requests:"
-echo ""
-cat << 'EOF'
-# Get cookies from your work profile
-COOKIES=$(get-cookie --url https://github.com --browser chrome --profile "Work" --render)
-curl -H "Cookie: $COOKIES" https://github.com/settings/profile
-
-# Get cookies from your personal profile  
-COOKIES=$(get-cookie --url https://github.com --browser chrome --profile "Personal" --render)
-curl -H "Cookie: $COOKIES" https://github.com/settings/profile
-EOF
-echo ""
-
-# Test with curl
-echo "🧪 Live Test with GitHub:"
-echo "──────────────────────"
-echo ""
-
-test_profile() {
-    local profile=$1
-    echo -n "Testing profile '$profile': "
-    
-    COOKIES=$(get-cookie --url https://github.com/settings/profile --browser chrome --profile "$profile" --render 2>/dev/null)
-    
-    if [ -z "$COOKIES" ]; then
-        echo "❌ No cookies found"
-        return
-    fi
-    
-    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
-        -H "Cookie: $COOKIES" \
-        -H "User-Agent: Mozilla/5.0" \
-        "https://github.com/settings/profile")
-    
-    if [ "$HTTP_CODE" = "200" ]; then
-        echo "✅ Authenticated (HTTP 200)"
-    elif [ "$HTTP_CODE" = "302" ]; then
-        echo "🔄 Redirected to login (HTTP 302)"
-    else
-        echo "⚠️  HTTP $HTTP_CODE"
-    fi
-}
-
-# Test each profile that might have GitHub cookies
-test_profile "Personal"
-test_profile "plugg.in"
-echo ""
-
-echo "📝 Usage Notes:"
-echo "────────────"
-echo "• Profile names are case-insensitive"
-echo "• You can use either the display name (e.g., \"Personal\") or directory name (e.g., \"Default\")"
-echo "• If no --profile is specified, all profiles are queried"
-echo "• Combine with --include-all to see cookies from all profiles even when one is selected"
-echo ""
-
-echo "✅ Profile selection feature is working perfectly!"

package/examples/curl-demo.sh

@@ -1,102 +0,0 @@
-#!/bin/bash
-
-# Simple demonstration of get-cookie + curl integration
-echo "🍪 get-cookie + curl Integration Demo"
-echo "======================================"
-
-# First, let's verify we have cookies
-echo -e "\n1️⃣ Checking available cookies..."
-COOKIE_COUNT=$(get-cookie % github.com --output json 2>/dev/null | jq 'length')
-echo "   Found $COOKIE_COUNT GitHub cookies"
-
-# Extract a specific cookie value
-echo -e "\n2️⃣ Extracting user_session cookie..."
-USER_SESSION=$(get-cookie user_session github.com --output json 2>/dev/null | jq -r '.[0].value' 2>/dev/null)
-
-if [ -n "$USER_SESSION" ] && [ "$USER_SESSION" != "null" ]; then
-    echo "   ✅ Got user_session cookie"
-    echo "   Value: ${USER_SESSION:0:20}... (truncated for security)"
-    
-    # Use the cookie with curl
-    echo -e "\n3️⃣ Making authenticated GitHub API request..."
-    RESPONSE=$(curl -s \
-        -H "Cookie: user_session=$USER_SESSION" \
-        -H "User-Agent: get-cookie-demo" \
-        "https://api.github.com/user")
-    
-    # Check if we got user data
-    LOGIN=$(echo "$RESPONSE" | jq -r '.login' 2>/dev/null)
-    if [ -n "$LOGIN" ] && [ "$LOGIN" != "null" ]; then
-        echo "   ✅ Authenticated as: @$LOGIN"
-        
-        # Get more user info
-        NAME=$(echo "$RESPONSE" | jq -r '.name' 2>/dev/null)
-        COMPANY=$(echo "$RESPONSE" | jq -r '.company' 2>/dev/null)
-        PUBLIC_REPOS=$(echo "$RESPONSE" | jq -r '.public_repos' 2>/dev/null)
-        
-        echo "   Name: $NAME"
-        [ "$COMPANY" != "null" ] && echo "   Company: $COMPANY"
-        echo "   Public repos: $PUBLIC_REPOS"
-    else
-        echo "   ⚠️ API did not return user data (cookie might not work for API)"
-    fi
-else
-    echo "   ❌ No user_session cookie found"
-fi
-
-# Example with multiple cookies
-echo -e "\n4️⃣ Building multi-cookie header..."
-COOKIES=""
-
-# Extract multiple cookies and combine them
-for cookie_name in "user_session" "dotcom_user" "__Host-user_session_same_site"; do
-    COOKIE_VALUE=$(get-cookie "$cookie_name" github.com --output json 2>/dev/null | jq -r '.[0].value' 2>/dev/null)
-    if [ -n "$COOKIE_VALUE" ] && [ "$COOKIE_VALUE" != "null" ]; then
-        [ -n "$COOKIES" ] && COOKIES="$COOKIES; "
-        COOKIES="$COOKIES$cookie_name=$COOKIE_VALUE"
-        echo "   ✅ Added $cookie_name"
-    fi
-done
-
-if [ -n "$COOKIES" ]; then
-    echo -e "\n5️⃣ Testing page access with cookies..."
-    # Test accessing a protected page
-    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
-        -H "Cookie: $COOKIES" \
-        -H "User-Agent: Mozilla/5.0" \
-        "https://github.com/settings/profile")
-    
-    if [ "$HTTP_CODE" = "200" ]; then
-        echo "   ✅ Successfully accessed settings page (HTTP 200)"
-    elif [ "$HTTP_CODE" = "302" ] || [ "$HTTP_CODE" = "301" ]; then
-        echo "   ⚠️ Redirected (HTTP $HTTP_CODE) - might need more cookies"
-    else
-        echo "   ❌ Access failed (HTTP $HTTP_CODE)"
-    fi
-fi
-
-# Practical example: Download with authentication
-echo -e "\n6️⃣ Example: Downloading with authentication..."
-echo "   Command to download your GitHub avatar:"
-if [ -n "$LOGIN" ]; then
-    echo "   curl -H \"Cookie: user_session=\$COOKIE\" -o avatar.png https://github.com/$LOGIN.png"
-else
-    echo "   curl -H \"Cookie: user_session=\$COOKIE\" -o avatar.png https://github.com/USERNAME.png"
-fi
-
-# One-liner examples
-echo -e "\n📝 Useful one-liners:"
-echo "────────────────────"
-echo "# Get cookie value only:"
-echo "get-cookie user_session github.com --output json | jq -r '.[0].value'"
-echo ""
-echo "# Direct pipe to curl:"
-echo "curl -H \"Cookie: user_session=\$(get-cookie user_session github.com --output json | jq -r '.[0].value')\" https://api.github.com/user"
-echo ""
-echo "# Save all cookies to file:"
-echo "get-cookie % github.com --output json > github-cookies.json"
-echo ""
-echo "# Use with HTTPie instead of curl:"
-echo "http https://api.github.com/user \"Cookie:user_session=\$(get-cookie user_session github.com --output json | jq -r '.[0].value')\""
-
-echo -e "\n✅ Demo complete!"

package/examples/curl-with-url.sh

@@ -1,136 +0,0 @@
-#!/bin/bash
-
-# Ultimate get-cookie + curl integration using --url flag
-echo "🚀 get-cookie + curl: The Perfect Integration"
-echo "============================================="
-echo ""
-echo "The --url flag automatically gets all cookies for a specific URL!"
-echo ""
-
-# Example 1: Simple one-liner for any URL
-echo "1️⃣ One-liner to curl any URL with cookies:"
-echo "─────────────────────────────────────────"
-echo 'curl -H "Cookie: $(get-cookie --url https://github.com/settings/profile --render)" https://github.com/settings/profile'
-echo ""
-
-# Example 2: Function for easy authenticated requests
-authenticated_curl() {
-    local url=$1
-    shift  # Remove first argument, pass the rest to curl
-    
-    # Get cookies for this specific URL
-    local cookies=$(get-cookie --url "$url" --render 2>/dev/null)
-    
-    if [ -n "$cookies" ]; then
-        curl -H "Cookie: $cookies" "$@" "$url"
-    else
-        echo "No cookies found for $url" >&2
-        curl "$@" "$url"
-    fi
-}
-
-echo "2️⃣ Testing authenticated requests:"
-echo "──────────────────────────────────"
-
-# Test GitHub settings page
-echo "• GitHub Settings:"
-HTTP_CODE=$(authenticated_curl "https://github.com/settings/profile" -s -o /dev/null -w "%{http_code}")
-if [ "$HTTP_CODE" = "200" ]; then
-    echo "  ✅ Successfully accessed (HTTP 200)"
-elif [ "$HTTP_CODE" = "302" ]; then
-    echo "  ⚠️ Redirected to login (HTTP 302)"
-else
-    echo "  ❌ Failed (HTTP $HTTP_CODE)"
-fi
-
-# Test Stack Overflow profile
-echo "• Stack Overflow Profile:"
-HTTP_CODE=$(authenticated_curl "https://stackoverflow.com/users/edit/current" -s -o /dev/null -w "%{http_code}")
-if [ "$HTTP_CODE" = "200" ]; then
-    echo "  ✅ Successfully accessed (HTTP 200)"
-elif [ "$HTTP_CODE" = "302" ] || [ "$HTTP_CODE" = "404" ]; then
-    echo "  ⚠️ Not logged in or no profile (HTTP $HTTP_CODE)"
-else
-    echo "  ❌ Failed (HTTP $HTTP_CODE)"
-fi
-
-echo ""
-echo "3️⃣ Practical Examples:"
-echo "────────────────────"
-
-# Download a file with authentication
-echo "• Download authenticated content:"
-echo '  curl -H "Cookie: $(get-cookie --url https://example.com/private/file.pdf --render)" \\'
-echo '       -o file.pdf https://example.com/private/file.pdf'
-
-# POST request with cookies
-echo ""
-echo "• POST with authentication:"
-echo '  curl -X POST \\'
-echo '       -H "Cookie: $(get-cookie --url https://api.example.com/endpoint --render)" \\'
-echo '       -H "Content-Type: application/json" \\'
-echo '       -d '"'"'{"key": "value"}'"'"' \\'
-echo '       https://api.example.com/endpoint'
-
-# Follow redirects with cookies
-echo ""
-echo "• Follow redirects while maintaining cookies:"
-echo '  curl -L \\'
-echo '       -H "Cookie: $(get-cookie --url https://example.com/dashboard --render)" \\'
-echo '       https://example.com/dashboard'
-
-echo ""
-echo "4️⃣ Advanced Usage:"
-echo "─────────────────"
-
-# Show what cookies would be sent for different URLs
-echo "• Preview cookies for different URLs:"
-for url in "https://github.com/" "https://api.github.com/" "https://gist.github.com/"; do
-    COOKIE_COUNT=$(get-cookie --url "$url" --output json 2>/dev/null | jq 'length // 0')
-    echo "  $url → $COOKIE_COUNT cookies"
-done
-
-echo ""
-echo "5️⃣ Shell Function for Your .bashrc/.zshrc:"
-echo "──────────────────────────────────────────"
-cat << 'EOF'
-# Add to your shell config for easy authenticated requests
-auth_curl() {
-    local url=$1
-    shift
-    curl -H "Cookie: $(get-cookie --url "$url" --render 2>/dev/null)" "$@" "$url"
-}
-
-# Usage: auth_curl https://github.com/settings/profile -s | grep username
-EOF
-
-echo ""
-echo "6️⃣ Comparison: Manual vs --url flag:"
-echo "────────────────────────────────────"
-echo "❌ Manual (need to know domain and cookie names):"
-echo '  get-cookie user_session github.com --render'
-echo ""
-echo "✅ With --url (automatic):"
-echo '  get-cookie --url https://github.com/settings/profile --render'
-echo ""
-echo "The --url flag automatically:"
-echo "  • Extracts the domain from the URL"
-echo "  • Gets ALL relevant cookies for that domain"
-echo "  • Handles subdomains correctly"
-echo "  • Returns cookies in the right format for curl"
-
-echo ""
-echo "7️⃣ Real Example - Download your GitHub avatar:"
-echo "──────────────────────────────────────────────"
-USERNAME=$(get-cookie dotcom_user github.com --render 2>/dev/null | cut -d'=' -f2 | cut -d';' -f1)
-if [ -n "$USERNAME" ]; then
-    echo "Downloading avatar for: $USERNAME"
-    echo "Command:"
-    echo "  curl -H \"Cookie: \$(get-cookie --url https://github.com/$USERNAME.png --render)\" \\"
-    echo "       -o avatar.png https://github.com/$USERNAME.png"
-else
-    echo "Not logged into GitHub"
-fi
-
-echo ""
-echo "✅ The --url flag makes cookie extraction automatic and foolproof!"