notion-debug-bundle

# Notion Debug Bundle ## Overview Collect diagnostic information for Notion API issues: SDK version, token validity, database access, page sharing status, rate limits, and platform health. The Notion API requires integrations to be explicitly invited to each page or database — most "not found" errors are sharing problems, not code bugs. ## Prerequisites - `@notionhq/client` installed (`npm ls @notionhq/client` to verify) - `NOTION_TOKEN` environment variable set (internal integration token, starts with `ntn_`) - `curl` and `jq` available for shell-based diagnostics ## Instructions ### Step 1: Quick Connectivity and Auth Check ```bash #!/bin/bash echo "=== Notion Debug Check ===" echo "Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ)" # 1. SDK version echo -e "\n--- SDK Version ---" npm ls @notionhq/client 2>/dev/null || echo "SDK not found — run: npm install @notionhq/client" # 2. Runtime and token status echo -e "\n--- Runtime ---" node --version 2>/dev/null || echo "Node.js not found" echo "NOTION_TOKEN: ${NOTION_TOKEN:+SET (${#NOTION_TOKEN} chars)}" TOKEN_PREFIX="${NOTION_TOKEN:0:4}" if [ -n "$NOTION_TOKEN" ] && [ "$TOKEN_PREFIX" != "ntn_" ]; then echo "WARNING: Token does not start with 'ntn_' — may be using legacy format" fi # 3. API connectivity — /v1/users/me as health check echo -e "\n--- API Connectivity ---" RESPONSE=$(curl -s -w "\n%{http_code}\n%{time_total}" \ https://api.notion.com/v1/users/me \ -H "Authorization: Bearer ${NOTION_TOKEN}" \ -H "Notion-...