diff --git a/package-lock.json b/package-lock.json index 077cbb88..46ebbd28 100644 --- a/package-lock.json +++ b/package-lock.json @@ -16,6 +16,7 @@ "express": "^5.1.0", "fast-levenshtein": "^3.0.0", "jose": "^6.0.12", + "puppeteer": "^24.23.0", "ts-results-es": "^5.0.1", "zod": "^3.24.3", "zod-validation-error": "^4.0.1" @@ -29,6 +30,7 @@ "@eslint/js": "^9.25.1", "@modelcontextprotocol/inspector": "^0.16.6", "@openai/agents": "^0.1.9", + "@tableau/embedding-api": "^3.14.2", "@types/cors": "^2.8.19", "@types/eslint__js": "^8.42.3", "@types/express": "^5.0.3", @@ -52,7 +54,7 @@ "vitest": "^3.1.3" }, "engines": { - "node": ">=20" + "node": ">=22.7.5" } }, "node_modules/@ampproject/remapping": { @@ -98,6 +100,26 @@ "node": ">= 4" } }, + "node_modules/@babel/code-frame": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", + "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==", + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.27.1", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/code-frame/node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "license": "MIT" + }, "node_modules/@babel/helper-string-parser": { "version": "7.27.1", "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", @@ -111,7 +133,6 @@ "version": "7.27.1", "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.27.1.tgz", "integrity": "sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==", - "dev": true, "engines": { "node": ">=6.9.0" } @@ -1422,6 +1443,27 @@ "url": "https://opencollective.com/pkgr" } }, + "node_modules/@puppeteer/browsers": { + "version": "2.10.10", + "resolved": "https://registry.npmjs.org/@puppeteer/browsers/-/browsers-2.10.10.tgz", + "integrity": "sha512-3ZG500+ZeLql8rE0hjfhkycJjDj0pI/btEh3L9IkWUYcOrgP0xCNRq3HbtbqOPbvDhFaAWD88pDFtlLv8ns8gA==", + "license": "Apache-2.0", + "dependencies": { + "debug": "^4.4.3", + "extract-zip": "^2.0.1", + "progress": "^2.0.3", + "proxy-agent": "^6.5.0", + "semver": "^7.7.2", + "tar-fs": "^3.1.0", + "yargs": "^17.7.2" + }, + "bin": { + "browsers": "lib/cjs/main-cli.js" + }, + "engines": { + "node": ">=18" + } + }, "node_modules/@radix-ui/number": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/@radix-ui/number/-/number-1.1.1.tgz", @@ -2536,6 +2578,67 @@ "win32" ] }, + "node_modules/@tableau/embedding-api": { + "version": "3.14.2", + "resolved": "https://registry.npmjs.org/@tableau/embedding-api/-/embedding-api-3.14.2.tgz", + "integrity": "sha512-7YuRH+JvmHQG3wyOI0cu0AXVSmA5I9cNUyVHl3C0mEhqUgFfDV1GANEPR8WHE3SEXiED3OrJuZRp9Ya9fZVh5Q==", + "bundleDependencies": [ + "@tableau/api-external-contract-js", + "@tableau/api-internal-contract-js", + "@tableau/api-shared-js" + ], + "dev": true, + "license": "SEE LICENSE IN LICENSE.md", + "dependencies": { + "@tableau/api-external-contract-js": "1.223.0", + "@tableau/api-internal-contract-js": "1.188.0", + "@tableau/api-shared-js": "1.277.0" + } + }, + "node_modules/@tableau/embedding-api/node_modules/@tableau/api-external-contract-js": { + "version": "1.223.0", + "dev": true, + "inBundle": true, + "license": "UNLICENSED" + }, + "node_modules/@tableau/embedding-api/node_modules/@tableau/api-internal-contract-js": { + "version": "1.188.0", + "dev": true, + "inBundle": true, + "license": "UNLICENSED", + "dependencies": { + "guid": "0.0.12" + } + }, + "node_modules/@tableau/embedding-api/node_modules/@tableau/api-shared-js": { + "version": "1.277.0", + "dev": true, + "inBundle": true, + "license": "UNLICENSED", + "dependencies": { + "uuid": "^8.0.0" + } + }, + "node_modules/@tableau/embedding-api/node_modules/guid": { + "version": "0.0.12", + "dev": true, + "inBundle": true + }, + "node_modules/@tableau/embedding-api/node_modules/uuid": { + "version": "8.3.2", + "dev": true, + "inBundle": true, + "license": "MIT", + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/@tootallnate/quickjs-emscripten": { + "version": "0.23.0", + "resolved": "https://registry.npmjs.org/@tootallnate/quickjs-emscripten/-/quickjs-emscripten-0.23.0.tgz", + "integrity": "sha512-C5Mc6rdnsaJDjO3UpGW/CQTHtCKaYlScZTly4JIu97Jxo/odCiH0ITnDXSJPTOrEKk/ycSZ0AOgTmkDtkOsvIA==", + "license": "MIT" + }, "node_modules/@tsconfig/node10": { "version": "1.0.11", "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz", @@ -2697,7 +2800,7 @@ "version": "22.15.30", "resolved": "https://registry.npmjs.org/@types/node/-/node-22.15.30.tgz", "integrity": "sha512-6Q7lr06bEHdlfplU6YRbgG1SFBdlsfNC4/lX+SkhiTs0cpJkOElmWls8PxDFv4yY/xKb8Y6SO0OmSX4wgqTZbA==", - "dev": true, + "devOptional": true, "dependencies": { "undici-types": "~6.21.0" } @@ -2756,6 +2859,16 @@ "@types/node": "*" } }, + "node_modules/@types/yauzl": { + "version": "2.10.3", + "resolved": "https://registry.npmjs.org/@types/yauzl/-/yauzl-2.10.3.tgz", + "integrity": "sha512-oJoftv0LSuaDZE3Le4DbKX+KS9G36NzOeSap90UIK0yMA/NhKJhqlSGtNDORNRaIbQfzjXDrQa0ytJ6mNRGz/Q==", + "license": "MIT", + "optional": true, + "dependencies": { + "@types/node": "*" + } + }, "node_modules/@typescript-eslint/eslint-plugin": { "version": "8.33.1", "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.33.1.tgz", @@ -3206,6 +3319,15 @@ "node": ">=0.4.0" } }, + "node_modules/agent-base": { + "version": "7.1.4", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz", + "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==", + "license": "MIT", + "engines": { + "node": ">= 14" + } + }, "node_modules/ajv": { "version": "6.12.6", "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", @@ -3253,7 +3375,6 @@ "version": "4.3.0", "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "dev": true, "dependencies": { "color-convert": "^2.0.1" }, @@ -3273,8 +3394,7 @@ "node_modules/argparse": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", - "dev": true + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==" }, "node_modules/aria-hidden": { "version": "1.2.6", @@ -3337,6 +3457,18 @@ "node": ">=12" } }, + "node_modules/ast-types": { + "version": "0.13.4", + "resolved": "https://registry.npmjs.org/ast-types/-/ast-types-0.13.4.tgz", + "integrity": "sha512-x1FCFnFifvYDDzTaLII71vG5uvDwgtmDTEVWAxrgeiR8VjMONcCXJx7E+USjDtHlwFmt9MysbqgF9b9Vjr6w+w==", + "license": "MIT", + "dependencies": { + "tslib": "^2.0.1" + }, + "engines": { + "node": ">=4" + } + }, "node_modules/ast-v8-to-istanbul": { "version": "0.3.3", "resolved": "https://registry.npmjs.org/ast-v8-to-istanbul/-/ast-v8-to-istanbul-0.3.3.tgz", @@ -3398,6 +3530,98 @@ "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", "dev": true }, + "node_modules/bare-events": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/bare-events/-/bare-events-2.7.0.tgz", + "integrity": "sha512-b3N5eTW1g7vXkw+0CXh/HazGTcO5KYuu/RCNaJbDMPI6LHDi+7qe8EmxKUVe1sUbY2KZOVZFyj62x0OEz9qyAA==", + "license": "Apache-2.0" + }, + "node_modules/bare-fs": { + "version": "4.4.5", + "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.4.5.tgz", + "integrity": "sha512-TCtu93KGLu6/aiGWzMr12TmSRS6nKdfhAnzTQRbXoSWxkbb9eRd53jQ51jG7g1gYjjtto3hbBrrhzg6djcgiKg==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "bare-events": "^2.5.4", + "bare-path": "^3.0.0", + "bare-stream": "^2.6.4", + "bare-url": "^2.2.2", + "fast-fifo": "^1.3.2" + }, + "engines": { + "bare": ">=1.16.0" + }, + "peerDependencies": { + "bare-buffer": "*" + }, + "peerDependenciesMeta": { + "bare-buffer": { + "optional": true + } + } + }, + "node_modules/bare-os": { + "version": "3.6.2", + "resolved": "https://registry.npmjs.org/bare-os/-/bare-os-3.6.2.tgz", + "integrity": "sha512-T+V1+1srU2qYNBmJCXZkUY5vQ0B4FSlL3QDROnKQYOqeiQR8UbjNHlPa+TIbM4cuidiN9GaTaOZgSEgsvPbh5A==", + "license": "Apache-2.0", + "optional": true, + "engines": { + "bare": ">=1.14.0" + } + }, + "node_modules/bare-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/bare-path/-/bare-path-3.0.0.tgz", + "integrity": "sha512-tyfW2cQcB5NN8Saijrhqn0Zh7AnFNsnczRcuWODH0eYAXBsJ5gVxAUuNr7tsHSC6IZ77cA0SitzT+s47kot8Mw==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "bare-os": "^3.0.1" + } + }, + "node_modules/bare-stream": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/bare-stream/-/bare-stream-2.7.0.tgz", + "integrity": "sha512-oyXQNicV1y8nc2aKffH+BUHFRXmx6VrPzlnaEvMhram0nPBrKcEdcyBg5r08D0i8VxngHFAiVyn1QKXpSG0B8A==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "streamx": "^2.21.0" + }, + "peerDependencies": { + "bare-buffer": "*", + "bare-events": "*" + }, + "peerDependenciesMeta": { + "bare-buffer": { + "optional": true + }, + "bare-events": { + "optional": true + } + } + }, + "node_modules/bare-url": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/bare-url/-/bare-url-2.2.2.tgz", + "integrity": "sha512-g+ueNGKkrjMazDG3elZO1pNs3HY5+mMmOet1jtKyhOaCnkLzitxf26z7hoAEkDNgdNmnc1KIlt/dw6Po6xZMpA==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "bare-path": "^3.0.0" + } + }, + "node_modules/basic-ftp": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/basic-ftp/-/basic-ftp-5.0.5.tgz", + "integrity": "sha512-4Bcg1P8xhUuqcii/S0Z9wiHIrQVPMermM1any+MX5GeGD7faD3/msQUDGLol9wOcz4/jbg/WJnGqoJF6LiBdtg==", + "license": "MIT", + "engines": { + "node": ">=10.0.0" + } + }, "node_modules/body-parser": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.0.tgz", @@ -3439,6 +3663,15 @@ "node": ">=8" } }, + "node_modules/buffer-crc32": { + "version": "0.2.13", + "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-0.2.13.tgz", + "integrity": "sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==", + "license": "MIT", + "engines": { + "node": "*" + } + }, "node_modules/bundle-name": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/bundle-name/-/bundle-name-4.1.0.tgz", @@ -3522,7 +3755,6 @@ "version": "3.1.0", "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", - "dev": true, "engines": { "node": ">=6" } @@ -3587,6 +3819,19 @@ "node": ">= 16" } }, + "node_modules/chromium-bidi": { + "version": "9.1.0", + "resolved": "https://registry.npmjs.org/chromium-bidi/-/chromium-bidi-9.1.0.tgz", + "integrity": "sha512-rlUzQ4WzIAWdIbY/viPShhZU2n21CxDUgazXVbw4Hu1MwaeUSEksSeM6DqPgpRjCLXRk702AVRxJxoOz0dw4OA==", + "license": "Apache-2.0", + "dependencies": { + "mitt": "^3.0.1", + "zod": "^3.24.1" + }, + "peerDependencies": { + "devtools-protocol": "*" + } + }, "node_modules/class-variance-authority": { "version": "0.7.1", "resolved": "https://registry.npmjs.org/class-variance-authority/-/class-variance-authority-0.7.1.tgz", @@ -3614,7 +3859,6 @@ "version": "8.0.1", "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz", "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", - "dev": true, "license": "ISC", "dependencies": { "string-width": "^4.2.0", @@ -3629,7 +3873,6 @@ "version": "5.0.1", "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", - "dev": true, "license": "MIT", "engines": { "node": ">=8" @@ -3639,14 +3882,12 @@ "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "dev": true, "license": "MIT" }, "node_modules/cliui/node_modules/string-width": { "version": "4.2.3", "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "dev": true, "license": "MIT", "dependencies": { "emoji-regex": "^8.0.0", @@ -3661,7 +3902,6 @@ "version": "6.0.1", "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "dev": true, "license": "MIT", "dependencies": { "ansi-regex": "^5.0.1" @@ -3674,7 +3914,6 @@ "version": "7.0.0", "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", - "dev": true, "license": "MIT", "dependencies": { "ansi-styles": "^4.0.0", @@ -3719,7 +3958,6 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "dev": true, "dependencies": { "color-name": "~1.1.4" }, @@ -3730,8 +3968,7 @@ "node_modules/color-name": { "version": "1.1.4", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" }, "node_modules/combined-stream": { "version": "1.0.8", @@ -3833,6 +4070,50 @@ "node": ">= 0.10" } }, + "node_modules/cosmiconfig": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-9.0.0.tgz", + "integrity": "sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==", + "license": "MIT", + "dependencies": { + "env-paths": "^2.2.1", + "import-fresh": "^3.3.0", + "js-yaml": "^4.1.0", + "parse-json": "^5.2.0" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/d-fischer" + }, + "peerDependencies": { + "typescript": ">=4.9.5" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/cosmiconfig/node_modules/parse-json": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", + "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.0.0", + "error-ex": "^1.3.1", + "json-parse-even-better-errors": "^2.3.0", + "lines-and-columns": "^1.1.6" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/create-require": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz", @@ -3852,6 +4133,15 @@ "node": ">= 8" } }, + "node_modules/data-uri-to-buffer": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/data-uri-to-buffer/-/data-uri-to-buffer-6.0.2.tgz", + "integrity": "sha512-7hvf7/GW8e86rW0ptuwS3OcBGDjIi6SZva7hCyWC0yYry2cOPmLIjXAUHI6DK2HsnwJd9ifmt57i8eV2n4YNpw==", + "license": "MIT", + "engines": { + "node": ">= 14" + } + }, "node_modules/data-view-buffer": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/data-view-buffer/-/data-view-buffer-1.0.2.tgz", @@ -3907,9 +4197,10 @@ } }, "node_modules/debug": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz", - "integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==", + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", "dependencies": { "ms": "^2.1.3" }, @@ -4016,6 +4307,20 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/degenerator": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/degenerator/-/degenerator-5.0.1.tgz", + "integrity": "sha512-TllpMR/t0M5sqCXfj85i4XaAzxmS5tVA16dqvdkMwGmzI+dXLXnw3J+3Vdv7VKw+ThlTMboK6i9rnZ6Nntj5CQ==", + "license": "MIT", + "dependencies": { + "ast-types": "^0.13.4", + "escodegen": "^2.1.0", + "esprima": "^4.0.1" + }, + "engines": { + "node": ">= 14" + } + }, "node_modules/delayed-stream": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", @@ -4040,6 +4345,12 @@ "dev": true, "license": "MIT" }, + "node_modules/devtools-protocol": { + "version": "0.0.1508733", + "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1508733.tgz", + "integrity": "sha512-QJ1R5gtck6nDcdM+nlsaJXcelPEI7ZxSMw1ujHpO1c4+9l+Nue5qlebi9xO1Z2MGr92bFOQTW7/rrheh5hHxDg==", + "license": "BSD-3-Clause" + }, "node_modules/diff": { "version": "4.0.2", "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz", @@ -4103,16 +4414,23 @@ "version": "1.4.4", "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.4.tgz", "integrity": "sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q==", - "dev": true, "dependencies": { "once": "^1.4.0" } }, + "node_modules/env-paths": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz", + "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, "node_modules/error-ex": { "version": "1.3.2", "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz", "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==", - "dev": true, "license": "MIT", "dependencies": { "is-arrayish": "^0.2.1" @@ -4296,7 +4614,6 @@ "version": "3.2.0", "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", - "dev": true, "license": "MIT", "engines": { "node": ">=6" @@ -4319,6 +4636,27 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/escodegen": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/escodegen/-/escodegen-2.1.0.tgz", + "integrity": "sha512-2NlIDTwUWJN0mRPQOdtQBzbUHvdGY2P1VXSyU83Q3xKxM7WHX2Ql8dKq782Q9TgQUNOLEzEYu9bzLNj1q88I5w==", + "license": "BSD-2-Clause", + "dependencies": { + "esprima": "^4.0.1", + "estraverse": "^5.2.0", + "esutils": "^2.0.2" + }, + "bin": { + "escodegen": "bin/escodegen.js", + "esgenerate": "bin/esgenerate.js" + }, + "engines": { + "node": ">=6.0" + }, + "optionalDependencies": { + "source-map": "~0.6.1" + } + }, "node_modules/eslint": { "version": "9.28.0", "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.28.0.tgz", @@ -4502,6 +4840,19 @@ "url": "https://opencollective.com/eslint" } }, + "node_modules/esprima": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", + "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", + "license": "BSD-2-Clause", + "bin": { + "esparse": "bin/esparse.js", + "esvalidate": "bin/esvalidate.js" + }, + "engines": { + "node": ">=4" + } + }, "node_modules/esquery": { "version": "1.6.0", "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", @@ -4530,7 +4881,6 @@ "version": "5.3.0", "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", - "dev": true, "engines": { "node": ">=4.0" } @@ -4548,7 +4898,6 @@ "version": "2.0.3", "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", - "dev": true, "engines": { "node": ">=0.10.0" } @@ -4561,6 +4910,15 @@ "node": ">= 0.6" } }, + "node_modules/events-universal": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/events-universal/-/events-universal-1.0.1.tgz", + "integrity": "sha512-LUd5euvbMLpwOF8m6ivPCbhQeSiYVNb8Vs0fQ8QjXo0JTkEHpz8pxdQf0gStltaPpw0Cca8b39KxvK9cfKRiAw==", + "license": "Apache-2.0", + "dependencies": { + "bare-events": "^2.7.0" + } + }, "node_modules/eventsource": { "version": "3.0.7", "resolved": "https://registry.npmjs.org/eventsource/-/eventsource-3.0.7.tgz", @@ -4763,6 +5121,41 @@ "node": ">=0.10.0" } }, + "node_modules/extract-zip": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extract-zip/-/extract-zip-2.0.1.tgz", + "integrity": "sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==", + "license": "BSD-2-Clause", + "dependencies": { + "debug": "^4.1.1", + "get-stream": "^5.1.0", + "yauzl": "^2.10.0" + }, + "bin": { + "extract-zip": "cli.js" + }, + "engines": { + "node": ">= 10.17.0" + }, + "optionalDependencies": { + "@types/yauzl": "^2.9.1" + } + }, + "node_modules/extract-zip/node_modules/get-stream": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-5.2.0.tgz", + "integrity": "sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA==", + "license": "MIT", + "dependencies": { + "pump": "^3.0.0" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/fast-deep-equal": { "version": "3.1.3", "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", @@ -4774,6 +5167,12 @@ "integrity": "sha512-VxPP4NqbUjj6MaAOafWeUn2cXWLcCtljklUtZf0Ind4XQ+QPtmA0b18zZy0jIQx+ExRVCR/ZQpBmik5lXshNsw==", "dev": true }, + "node_modules/fast-fifo": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/fast-fifo/-/fast-fifo-1.3.2.tgz", + "integrity": "sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==", + "license": "MIT" + }, "node_modules/fast-glob": { "version": "3.3.3", "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", @@ -4834,6 +5233,15 @@ "reusify": "^1.0.4" } }, + "node_modules/fd-slicer": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fd-slicer/-/fd-slicer-1.1.0.tgz", + "integrity": "sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==", + "license": "MIT", + "dependencies": { + "pend": "~1.2.0" + } + }, "node_modules/fflate": { "version": "0.8.2", "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.2.tgz", @@ -5124,7 +5532,6 @@ "version": "2.0.5", "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", - "dev": true, "license": "ISC", "engines": { "node": "6.* || 8.* || >= 10.*" @@ -5205,6 +5612,20 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/get-uri": { + "version": "6.0.5", + "resolved": "https://registry.npmjs.org/get-uri/-/get-uri-6.0.5.tgz", + "integrity": "sha512-b1O07XYq8eRuVzBNgJLstU6FYc1tS6wnMtF1I1D9lE8LxZSOGZ7LhxN54yPP6mGw5f2CkXY2BQUL9Fx41qvcIg==", + "license": "MIT", + "dependencies": { + "basic-ftp": "^5.0.2", + "data-uri-to-buffer": "^6.0.2", + "debug": "^4.3.4" + }, + "engines": { + "node": ">= 14" + } + }, "node_modules/glob": { "version": "11.0.2", "resolved": "https://registry.npmjs.org/glob/-/glob-11.0.2.tgz", @@ -5432,6 +5853,32 @@ "node": ">= 0.8" } }, + "node_modules/http-proxy-agent": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz", + "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==", + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.0", + "debug": "^4.3.4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/https-proxy-agent": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", + "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.2", + "debug": "4" + }, + "engines": { + "node": ">= 14" + } + }, "node_modules/iconv-lite": { "version": "0.6.3", "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", @@ -5456,7 +5903,6 @@ "version": "3.3.1", "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", - "dev": true, "dependencies": { "parent-module": "^1.0.0", "resolve-from": "^4.0.0" @@ -5506,6 +5952,15 @@ "node": ">= 0.10" } }, + "node_modules/ip-address": { + "version": "10.0.1", + "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.0.1.tgz", + "integrity": "sha512-NWv9YLW4PoW2B7xtzaS3NCot75m6nK7Icdv0o3lfMceJVRfSoQwqD4wEH5rLwoKJwUiZ/rfpiVBhnaF0FK4HoA==", + "license": "MIT", + "engines": { + "node": ">= 12" + } + }, "node_modules/ipaddr.js": { "version": "1.9.1", "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", @@ -5536,7 +5991,6 @@ "version": "0.2.1", "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==", - "dev": true, "license": "MIT" }, "node_modules/is-async-function": { @@ -5700,7 +6154,6 @@ "version": "3.0.0", "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", - "dev": true, "engines": { "node": ">=8" } @@ -6090,7 +6543,6 @@ "version": "4.1.0", "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", - "dev": true, "dependencies": { "argparse": "^2.0.1" }, @@ -6111,6 +6563,12 @@ "dev": true, "license": "MIT" }, + "node_modules/json-parse-even-better-errors": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", + "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", + "license": "MIT" + }, "node_modules/json-schema-traverse": { "version": "0.4.1", "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", @@ -6157,6 +6615,12 @@ "node": ">= 0.8.0" } }, + "node_modules/lines-and-columns": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", + "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", + "license": "MIT" + }, "node_modules/load-json-file": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-4.0.0.tgz", @@ -6387,6 +6851,12 @@ "node": ">=16 || 14 >=14.17" } }, + "node_modules/mitt": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/mitt/-/mitt-3.0.1.tgz", + "integrity": "sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==", + "license": "MIT" + }, "node_modules/ms": { "version": "2.1.3", "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", @@ -6435,6 +6905,15 @@ "node": ">= 0.6" } }, + "node_modules/netmask": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/netmask/-/netmask-2.0.2.tgz", + "integrity": "sha512-dBpDMdxv9Irdq66304OLfEmQ9tbNRFnFTuZiLo+bD+r332bBmMJ8GBLXklIXXgxd3+v9+KUnZaUR5PJMa75Gsg==", + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, "node_modules/nice-try": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/nice-try/-/nice-try-1.0.5.tgz", @@ -6873,6 +7352,38 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/pac-proxy-agent": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/pac-proxy-agent/-/pac-proxy-agent-7.2.0.tgz", + "integrity": "sha512-TEB8ESquiLMc0lV8vcd5Ql/JAKAoyzHFXaStwjkzpOpC5Yv+pIzLfHvjTSdf3vpa2bMiUQrg9i6276yn8666aA==", + "license": "MIT", + "dependencies": { + "@tootallnate/quickjs-emscripten": "^0.23.0", + "agent-base": "^7.1.2", + "debug": "^4.3.4", + "get-uri": "^6.0.1", + "http-proxy-agent": "^7.0.0", + "https-proxy-agent": "^7.0.6", + "pac-resolver": "^7.0.1", + "socks-proxy-agent": "^8.0.5" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/pac-resolver": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/pac-resolver/-/pac-resolver-7.0.1.tgz", + "integrity": "sha512-5NPgf87AT2STgwa2ntRMr45jTKrYBGkVU36yT0ig/n/GMAa3oPqhZfIQ2kMEimReg0+t9kZViDVZ83qfVUlckg==", + "license": "MIT", + "dependencies": { + "degenerator": "^5.0.0", + "netmask": "^2.0.2" + }, + "engines": { + "node": ">= 14" + } + }, "node_modules/package-json-from-dist": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz", @@ -6883,7 +7394,6 @@ "version": "1.0.1", "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", - "dev": true, "dependencies": { "callsites": "^3.0.0" }, @@ -6995,11 +7505,16 @@ "node": ">= 14.16" } }, + "node_modules/pend": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/pend/-/pend-1.2.0.tgz", + "integrity": "sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==", + "license": "MIT" + }, "node_modules/picocolors": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", - "dev": true, "license": "ISC" }, "node_modules/picomatch": { @@ -7145,6 +7660,15 @@ "node": ">=6" } }, + "node_modules/progress": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz", + "integrity": "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==", + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, "node_modules/proxy-addr": { "version": "2.0.7", "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", @@ -7157,17 +7681,43 @@ "node": ">= 0.10" } }, + "node_modules/proxy-agent": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/proxy-agent/-/proxy-agent-6.5.0.tgz", + "integrity": "sha512-TmatMXdr2KlRiA2CyDu8GqR8EjahTG3aY3nXjdzFyoZbmB8hrBsTyMezhULIXKnC0jpfjlmiZ3+EaCzoInSu/A==", + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.2", + "debug": "^4.3.4", + "http-proxy-agent": "^7.0.1", + "https-proxy-agent": "^7.0.6", + "lru-cache": "^7.14.1", + "pac-proxy-agent": "^7.1.0", + "proxy-from-env": "^1.1.0", + "socks-proxy-agent": "^8.0.5" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/proxy-agent/node_modules/lru-cache": { + "version": "7.18.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-7.18.3.tgz", + "integrity": "sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, "node_modules/proxy-from-env": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.1.0.tgz", - "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==", - "peer": true + "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==" }, "node_modules/pump": { "version": "3.0.2", "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.2.tgz", "integrity": "sha512-tUPXtzlGM8FE3P0ZL6DVs/3P58k9nk8/jZeQCurTJylQA8qFYzHFfhBJkuqyE0FifOsQ0uKWekiZ5g8wtr28cw==", - "dev": true, "dependencies": { "end-of-stream": "^1.1.0", "once": "^1.3.1" @@ -7181,6 +7731,45 @@ "node": ">=6" } }, + "node_modules/puppeteer": { + "version": "24.23.0", + "resolved": "https://registry.npmjs.org/puppeteer/-/puppeteer-24.23.0.tgz", + "integrity": "sha512-BVR1Lg8sJGKXY79JARdIssFWK2F6e1j+RyuJP66w4CUmpaXjENicmA3nNpUXA8lcTdDjAndtP+oNdni3T/qQqA==", + "hasInstallScript": true, + "license": "Apache-2.0", + "dependencies": { + "@puppeteer/browsers": "2.10.10", + "chromium-bidi": "9.1.0", + "cosmiconfig": "^9.0.0", + "devtools-protocol": "0.0.1508733", + "puppeteer-core": "24.23.0", + "typed-query-selector": "^2.12.0" + }, + "bin": { + "puppeteer": "lib/cjs/puppeteer/node/cli.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/puppeteer-core": { + "version": "24.23.0", + "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-24.23.0.tgz", + "integrity": "sha512-yl25C59gb14sOdIiSnJ08XiPP+O2RjuyZmEG+RjYmCXO7au0jcLf7fRiyii96dXGUBW7Zwei/mVKfxMx/POeFw==", + "license": "Apache-2.0", + "dependencies": { + "@puppeteer/browsers": "2.10.10", + "chromium-bidi": "9.1.0", + "debug": "^4.4.3", + "devtools-protocol": "0.0.1508733", + "typed-query-selector": "^2.12.0", + "webdriver-bidi-protocol": "0.3.6", + "ws": "^8.18.3" + }, + "engines": { + "node": ">=18" + } + }, "node_modules/qs": { "version": "6.14.0", "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz", @@ -7422,7 +8011,6 @@ "version": "2.1.1", "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", - "dev": true, "license": "MIT", "engines": { "node": ">=0.10.0" @@ -7452,7 +8040,6 @@ "version": "4.0.0", "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", - "dev": true, "engines": { "node": ">=4" } @@ -7681,7 +8268,6 @@ "version": "7.7.2", "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz", "integrity": "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==", - "dev": true, "bin": { "semver": "bin/semver.js" }, @@ -8005,6 +8591,54 @@ "url": "https://github.com/sponsors/isaacs" } }, + "node_modules/smart-buffer": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/smart-buffer/-/smart-buffer-4.2.0.tgz", + "integrity": "sha512-94hK0Hh8rPqQl2xXc3HsaBoOXKV20MToPkcXvwbISWLEs+64sBq5kFgn2kJDHb1Pry9yrP0dxrCI9RRci7RXKg==", + "license": "MIT", + "engines": { + "node": ">= 6.0.0", + "npm": ">= 3.0.0" + } + }, + "node_modules/socks": { + "version": "2.8.7", + "resolved": "https://registry.npmjs.org/socks/-/socks-2.8.7.tgz", + "integrity": "sha512-HLpt+uLy/pxB+bum/9DzAgiKS8CX1EvbWxI4zlmgGCExImLdiad2iCwXT5Z4c9c3Eq8rP2318mPW2c+QbtjK8A==", + "license": "MIT", + "dependencies": { + "ip-address": "^10.0.1", + "smart-buffer": "^4.2.0" + }, + "engines": { + "node": ">= 10.0.0", + "npm": ">= 3.0.0" + } + }, + "node_modules/socks-proxy-agent": { + "version": "8.0.5", + "resolved": "https://registry.npmjs.org/socks-proxy-agent/-/socks-proxy-agent-8.0.5.tgz", + "integrity": "sha512-HehCEsotFqbPW9sJ8WVYB6UbmIMv7kUUORIF2Nncq4VQvBfNBLibW9YZR5dlYCSUhwcD628pRllm7n+E+YTzJw==", + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.2", + "debug": "^4.3.4", + "socks": "^2.8.3" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/source-map": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", + "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", + "license": "BSD-3-Clause", + "optional": true, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/source-map-js": { "version": "1.2.1", "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", @@ -8095,6 +8729,17 @@ "node": ">= 0.4" } }, + "node_modules/streamx": { + "version": "2.23.0", + "resolved": "https://registry.npmjs.org/streamx/-/streamx-2.23.0.tgz", + "integrity": "sha512-kn+e44esVfn2Fa/O0CPFcex27fjIL6MkVae0Mm6q+E6f0hWv578YCERbv+4m02cjxvDsPKLnmxral/rR6lBMAg==", + "license": "MIT", + "dependencies": { + "events-universal": "^1.0.0", + "fast-fifo": "^1.3.2", + "text-decoder": "^1.1.0" + } + }, "node_modules/string-width": { "version": "5.1.2", "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", @@ -8354,6 +8999,45 @@ "url": "https://github.com/sponsors/dcastil" } }, + "node_modules/tar-fs": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-3.1.1.tgz", + "integrity": "sha512-LZA0oaPOc2fVo82Txf3gw+AkEd38szODlptMYejQUhndHMLQ9M059uXR+AfS7DNo0NpINvSqDsvyaCrBVkptWg==", + "license": "MIT", + "dependencies": { + "pump": "^3.0.0", + "tar-stream": "^3.1.5" + }, + "optionalDependencies": { + "bare-fs": "^4.0.1", + "bare-path": "^3.0.0" + } + }, + "node_modules/tar-stream": { + "version": "3.1.7", + "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-3.1.7.tgz", + "integrity": "sha512-qJj60CXt7IU1Ffyc3NJMjh6EkuCFej46zUqJ4J7pqYlThyd9bO0XBTmcOIhSzZJVWfsLks0+nle/j538YAW9RQ==", + "license": "MIT", + "dependencies": { + "b4a": "^1.6.4", + "fast-fifo": "^1.2.0", + "streamx": "^2.15.0" + } + }, + "node_modules/tar-stream/node_modules/b4a": { + "version": "1.7.3", + "resolved": "https://registry.npmjs.org/b4a/-/b4a-1.7.3.tgz", + "integrity": "sha512-5Q2mfq2WfGuFp3uS//0s6baOJLMoVduPYVeNmDYxu5OUA1/cBfvr2RIS7vi62LdNj/urk1hfmj867I3qt6uZ7Q==", + "license": "Apache-2.0", + "peerDependencies": { + "react-native-b4a": "*" + }, + "peerDependenciesMeta": { + "react-native-b4a": { + "optional": true + } + } + }, "node_modules/test-exclude": { "version": "7.0.1", "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-7.0.1.tgz", @@ -8449,6 +9133,29 @@ "url": "https://github.com/sponsors/isaacs" } }, + "node_modules/text-decoder": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/text-decoder/-/text-decoder-1.2.3.tgz", + "integrity": "sha512-3/o9z3X0X0fTupwsYvR03pJ/DjWuqqrfwBgTQzdWDiQSm9KitAyz/9WqsT2JQW7KV2m+bC2ol/zqpW37NHxLaA==", + "license": "Apache-2.0", + "dependencies": { + "b4a": "^1.6.4" + } + }, + "node_modules/text-decoder/node_modules/b4a": { + "version": "1.7.3", + "resolved": "https://registry.npmjs.org/b4a/-/b4a-1.7.3.tgz", + "integrity": "sha512-5Q2mfq2WfGuFp3uS//0s6baOJLMoVduPYVeNmDYxu5OUA1/cBfvr2RIS7vi62LdNj/urk1hfmj867I3qt6uZ7Q==", + "license": "Apache-2.0", + "peerDependencies": { + "react-native-b4a": "*" + }, + "peerDependenciesMeta": { + "react-native-b4a": { + "optional": true + } + } + }, "node_modules/tinybench": { "version": "2.9.0", "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz", @@ -8643,7 +9350,6 @@ "version": "2.8.1", "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", - "dev": true, "license": "0BSD" }, "node_modules/type-check": { @@ -8762,11 +9468,17 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/typed-query-selector": { + "version": "2.12.0", + "resolved": "https://registry.npmjs.org/typed-query-selector/-/typed-query-selector-2.12.0.tgz", + "integrity": "sha512-SbklCd1F0EiZOyPiW192rrHZzZ5sBijB6xM+cpmrwDqObvdtunOHHIk9fCGsoK5JVIYXoyEp4iEdE3upFH3PAg==", + "license": "MIT" + }, "node_modules/typescript": { "version": "5.8.3", "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.8.3.tgz", "integrity": "sha512-p1diW6TqL9L07nNxvRMM7hMMw4c5XOo/1ibL4aAIGmSAt9slTE1Xgw5KWuof2uTOvCg9BY7ZRi+GaF+7sfgPeQ==", - "dev": true, + "devOptional": true, "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" @@ -8820,7 +9532,7 @@ "version": "6.21.0", "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", - "dev": true + "devOptional": true }, "node_modules/universalify": { "version": "2.0.1", @@ -9130,6 +9842,12 @@ "url": "https://github.com/sponsors/jonschlinkert" } }, + "node_modules/webdriver-bidi-protocol": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/webdriver-bidi-protocol/-/webdriver-bidi-protocol-0.3.6.tgz", + "integrity": "sha512-mlGndEOA9yK9YAbvtxaPTqdi/kaCWYYfwrZvGzcmkr/3lWM+tQj53BxtpVd6qbC6+E5OnHXgCcAhre6AkXzxjA==", + "license": "Apache-2.0" + }, "node_modules/which": { "version": "2.0.2", "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", @@ -9355,7 +10073,6 @@ "version": "8.18.3", "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.3.tgz", "integrity": "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==", - "dev": true, "license": "MIT", "engines": { "node": ">=10.0.0" @@ -9393,7 +10110,6 @@ "version": "5.0.8", "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", - "dev": true, "license": "ISC", "engines": { "node": ">=10" @@ -9403,7 +10119,6 @@ "version": "17.7.2", "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz", "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==", - "dev": true, "license": "MIT", "dependencies": { "cliui": "^8.0.1", @@ -9422,7 +10137,6 @@ "version": "21.1.1", "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", - "dev": true, "license": "ISC", "engines": { "node": ">=12" @@ -9432,7 +10146,6 @@ "version": "5.0.1", "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", - "dev": true, "license": "MIT", "engines": { "node": ">=8" @@ -9442,14 +10155,12 @@ "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "dev": true, "license": "MIT" }, "node_modules/yargs/node_modules/string-width": { "version": "4.2.3", "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "dev": true, "license": "MIT", "dependencies": { "emoji-regex": "^8.0.0", @@ -9464,7 +10175,6 @@ "version": "6.0.1", "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "dev": true, "license": "MIT", "dependencies": { "ansi-regex": "^5.0.1" @@ -9473,6 +10183,16 @@ "node": ">=8" } }, + "node_modules/yauzl": { + "version": "2.10.0", + "resolved": "https://registry.npmjs.org/yauzl/-/yauzl-2.10.0.tgz", + "integrity": "sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==", + "license": "MIT", + "dependencies": { + "buffer-crc32": "~0.2.3", + "fd-slicer": "~1.1.0" + } + }, "node_modules/yn": { "version": "3.1.1", "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz", diff --git a/package.json b/package.json index f4d9af7a..c7c64981 100644 --- a/package.json +++ b/package.json @@ -20,6 +20,7 @@ }, "scripts": { ":build": "npx rimraf ./build && esbuild src/index.ts --bundle --packages=external --platform=node --format=esm --minify --outdir=build --sourcemap", + ":build:dev": "npx rimraf ./build && esbuild src/index.ts --bundle --packages=external --platform=node --format=esm --outdir=build --sourcemap", "build": "run-s :build exec-perms", "build:watch": "npm run :build -- --watch", "build:docker": "docker build -t tableau-mcp .", @@ -55,6 +56,7 @@ "express": "^5.1.0", "fast-levenshtein": "^3.0.0", "jose": "^6.0.12", + "puppeteer": "^24.23.0", "ts-results-es": "^5.0.1", "zod": "^3.24.3", "zod-validation-error": "^4.0.1" @@ -65,6 +67,7 @@ "@eslint/js": "^9.25.1", "@modelcontextprotocol/inspector": "^0.16.6", "@openai/agents": "^0.1.9", + "@tableau/embedding-api": "^3.14.2", "@types/cors": "^2.8.19", "@types/eslint__js": "^8.42.3", "@types/express": "^5.0.3", diff --git a/src/config.ts b/src/config.ts index 9518048a..83a0675e 100644 --- a/src/config.ts +++ b/src/config.ts @@ -44,6 +44,7 @@ export class Config { enableServerLogging: boolean; serverLogDirectory: string; boundedContext: BoundedContext; + useHeadedBrowser: boolean; constructor() { const cleansedVars = removeClaudeMcpBundleUserConfigTemplates(process.env); @@ -76,6 +77,7 @@ export class Config { INCLUDE_PROJECT_IDS: includeProjectIds, INCLUDE_DATASOURCE_IDS: includeDatasourceIds, INCLUDE_WORKBOOK_IDS: includeWorkbookIds, + USE_HEADED_BROWSER: useHeadedBrowser, } = cleansedVars; const defaultPort = 3927; @@ -94,6 +96,7 @@ export class Config { this.disableLogMasking = disableLogMasking === 'true'; this.disableQueryDatasourceFilterValidation = disableQueryDatasourceFilterValidation === 'true'; this.disableMetadataApiRequests = disableMetadataApiRequests === 'true'; + this.useHeadedBrowser = useHeadedBrowser === 'true'; this.enableServerLogging = enableServerLogging === 'true'; this.serverLogDirectory = serverLogDirectory || join(__dirname, 'logs'); this.boundedContext = { diff --git a/src/index.ts b/src/index.ts index 57b95bbc..1c27dba9 100644 --- a/src/index.ts +++ b/src/index.ts @@ -1,12 +1,14 @@ #!/usr/bin/env node import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'; import dotenv from 'dotenv'; +import express from 'express'; import { getConfig } from './config.js'; import { isLoggingLevel, log, setLogLevel, setServerLogger, writeToStderr } from './logging/log.js'; import { ServerLogger } from './logging/serverLogger.js'; import { Server, serverName, serverVersion } from './server.js'; import { startExpressServer } from './server/express.js'; +import { embedHtml } from './tools/views/embed.html.js'; import { getExceptionMessage } from './utils/getExceptionMessage.js'; async function startServer(): Promise { @@ -24,6 +26,17 @@ async function startServer(): Promise { server.registerTools(); server.registerRequestHandlers(); + const app = express(); + + app.get('/embed', (req, res) => { + res.set('Content-Type', 'text/html'); + res.send(Buffer.from(embedHtml)); + }); + + app.listen(config.httpPort, () => { + log.info(server, `Embed server running on port ${config.httpPort}`); + }); + const transport = new StdioServerTransport(); await server.connect(transport); diff --git a/src/restApiInstance.ts b/src/restApiInstance.ts index 192a562b..88211d66 100644 --- a/src/restApiInstance.ts +++ b/src/restApiInstance.ts @@ -16,6 +16,7 @@ import { import RestApi from './sdks/tableau/restApi.js'; import { Server } from './server.js'; import { getExceptionMessage } from './utils/getExceptionMessage.js'; +import { getJwtAdditionalPayload, getJwtSubClaim } from './utils/getJwt.js'; import { isAxiosError } from './utils/isAxiosError.js'; type JwtScopes = @@ -196,12 +197,3 @@ function logResponse( log.info(server, messageObj, { logger: 'rest-api', requestId }); } - -function getJwtSubClaim(config: Config): string { - return config.jwtSubClaim; -} - -function getJwtAdditionalPayload(config: Config): Record { - const json = config.jwtAdditionalPayload; - return JSON.parse(json || '{}'); -} diff --git a/src/server/express.ts b/src/server/express.ts index 97a53703..5448b6ea 100644 --- a/src/server/express.ts +++ b/src/server/express.ts @@ -9,6 +9,7 @@ import https from 'https'; import { Config } from '../config.js'; import { setLogLevel } from '../logging/log.js'; import { Server } from '../server.js'; +import { embedHtml } from '../tools/views/embed.html.js'; export async function startExpressServer({ basePath, @@ -43,6 +44,10 @@ export async function startExpressServer({ app.post(path, createMcpServer); app.get(path, methodNotAllowed); app.delete(path, methodNotAllowed); + app.get('/embed', (req, res) => { + res.set('Content-Type', 'text/html'); + res.send(Buffer.from(embedHtml)); + }); const useSsl = !!(config.sslKey && config.sslCert); if (!useSsl) { diff --git a/src/tools/toolName.ts b/src/tools/toolName.ts index aeb8a0a9..7689d077 100644 --- a/src/tools/toolName.ts +++ b/src/tools/toolName.ts @@ -14,6 +14,7 @@ export const toolNames = [ 'list-pulse-metric-subscriptions', 'generate-pulse-metric-value-insight-bundle', 'search-content', + 'embed-workbook', ] as const; export type ToolName = (typeof toolNames)[number]; @@ -23,6 +24,7 @@ export const toolGroupNames = [ 'view', 'pulse', 'content-exploration', + 'embedding', ] as const; export type ToolGroupName = (typeof toolGroupNames)[number]; @@ -39,6 +41,7 @@ export const toolGroups = { 'generate-pulse-metric-value-insight-bundle', ], 'content-exploration': ['search-content'], + embedding: ['embed-workbook'], } as const satisfies Record>; export function isToolName(value: unknown): value is ToolName { diff --git a/src/tools/views/browserController.ts b/src/tools/views/browserController.ts new file mode 100644 index 00000000..d9103aae --- /dev/null +++ b/src/tools/views/browserController.ts @@ -0,0 +1,334 @@ +import { randomUUID } from 'crypto'; +import fs from 'fs'; +import path, { dirname } from 'path'; +import { Browser, BrowserContext, CDPSession, Page } from 'puppeteer'; +import puppeteer, { ScreenshotOptions } from 'puppeteer-core'; +import { Err, Ok, Result } from 'ts-results-es'; +import { fileURLToPath } from 'url'; + +const __filename = fileURLToPath(import.meta.url); +const __dirname = dirname(__filename); + +export type BrowserOptions = { + width?: number; + height?: number; +}; + +const browserControllerErrors = [ + 'browser-creation-failed', + 'browser-context-creation-failed', + 'page-creation-failed', + 'enable-downloads-failed', + 'download-failed', + 'navigation-failed', + 'page-failed-to-load', + 'viz-load-error', + 'screenshot-failed', + 'unknown', +] as const; + +type BrowserControllerErrorType = (typeof browserControllerErrors)[number]; + +export function isBrowserControllerErrorType(value: unknown): value is BrowserControllerErrorType { + return browserControllerErrors.find((error) => error === value) !== undefined; +} + +export type BrowserControllerError = { + type: BrowserControllerErrorType; + error: unknown; +}; + +export class BrowserController { + private _error: BrowserControllerError | undefined; + private _browser: Browser | undefined; + private _browserContext: BrowserContext | undefined; + private _page: Page | undefined; + private _browserCDPSession: CDPSession | undefined; + private _downloadPath: string | undefined; + private _screenshot: Uint8Array | undefined; + + private constructor() {} + + static async create({ headless = true }: { headless?: boolean } = {}): Promise< + Pick + > { + return Promise.resolve(new BrowserController()) + .then((renderer) => renderer._createBrowser({ headless })) + .then((renderer) => renderer._createBrowserContext()); + } + + private get browser(): Browser { + if (!this._browser) { + throw new Error('Browser not created'); + } + + return this._browser; + } + + private get browserContext(): BrowserContext { + if (!this._browserContext) { + throw new Error('Browser context not created'); + } + + return this._browserContext; + } + + get page(): Page { + if (!this._page) { + throw new Error('Page not created'); + } + + return this._page; + } + + get screenshot(): Uint8Array { + if (!this._screenshot) { + throw new Error('Screenshot not taken'); + } + + return this._screenshot; + } + + private get downloadPath(): string { + if (!this._downloadPath) { + throw new Error('Download path not set'); + } + + return this._downloadPath; + } + + private get browserCDPSession(): CDPSession { + if (!this._browserCDPSession) { + throw new Error('Browser CDP session not created'); + } + + return this._browserCDPSession; + } + + private async _createBrowser({ headless }: { headless: boolean }): Promise { + try { + this._browser = await puppeteer.launch({ + headless, + }); + } catch (error) { + this._error = { type: 'browser-creation-failed', error }; + } + + return this; + } + + private async _createBrowserContext(): Promise { + if (this._error) { + return this; + } + + try { + this._browserContext = await this.browser.createBrowserContext(); + } catch (error) { + this._error = { type: 'browser-context-creation-failed', error }; + } + + return this; + } + + async createNewPage( + options: BrowserOptions, + ): Promise> { + if (this._error) { + return this; + } + + try { + this._page = await this.browserContext.newPage(); + await this._page.setViewport({ + width: options.width ?? 800, + height: options.height ?? 600, + }); + } catch (error) { + this._error = { type: 'page-creation-failed', error }; + } + + return this; + } + + async enableDownloads(): Promise> { + if (this._error) { + return this; + } + + try { + this._browserCDPSession = await this.browser.target().createCDPSession(); + this._downloadPath = path.resolve(__dirname, 'downloads', randomUUID()); + if (!fs.existsSync(this._downloadPath)) { + fs.mkdirSync(this._downloadPath, { recursive: true }); + } + + const pageCDPSession = await this.page.createCDPSession(); + await pageCDPSession.send('Page.setDownloadBehavior', { + behavior: 'allow', + downloadPath: this._downloadPath, + }); + + await this._browserCDPSession.send('Browser.setDownloadBehavior', { + behavior: 'allowAndName', + downloadPath: this._downloadPath, + eventsEnabled: true, + }); + } catch (error) { + this._error = { type: 'enable-downloads-failed', error }; + } + + return this; + } + + async navigate(url: string): Promise> { + if (this._error) { + return this; + } + + try { + await this.page.goto(url, { waitUntil: 'networkidle2' }); + } catch (error) { + this._error = { type: 'navigation-failed', error }; + } + + return this; + } + + async waitForPageLoad(): Promise> { + if (this._error) { + return this; + } + + try { + const handle = await this.page.waitForFunction(isPageLoadedAndStable, { timeout: 10000 }); + const result = await handle.jsonValue(); + if (result && result.state === 'error') { + this._error = { type: 'viz-load-error', error: JSON.parse(result.message) }; + } + } catch (error) { + this._error = { type: 'unknown', error }; + } + + return this; + } + + async takeScreenshot(): Promise> { + if (this._error) { + return this; + } + + try { + const screenshotOptions: ScreenshotOptions = { + type: 'png', + fullPage: true, + omitBackground: false, + }; + + this._screenshot = await this.page.screenshot(screenshotOptions); + } catch (error) { + this._error = { type: 'screenshot-failed', error }; + } + + return this; + } + + async waitForDownloads(): Promise> { + if (this._error) { + return this; + } + + try { + await new Promise((resolve, reject) => { + this.browserCDPSession.on('Browser.downloadProgress', (e) => { + if (e.state === 'completed') { + resolve(); + } else if (e.state === 'canceled') { + reject('Download canceled'); + } + }); + }); + } catch (error) { + this._error = { type: 'download-failed', error }; + } + + return this; + } + + async getAndDeleteDownloads(): Promise> { + const files = fs.readdirSync(this.downloadPath); + const fileContents = files.map((filename) => ({ + filename, + content: fs.readFileSync(path.join(this.downloadPath, filename), 'utf8'), + })); + + fs.rmdirSync(this.downloadPath, { recursive: true }); + return fileContents; + } + + async getResult(): Promise> { + if (this._error) { + return Err(this._error); + } + + try { + await this._page?.close(); + await this._browserContext?.close(); + } catch { + // ignore + } + + return Ok(this); + } +} + +function isPageLoadedAndStable(): + | false + | { state: 'loaded' } + | { state: 'error'; message: string } { + const navigationTiming = performance?.getEntriesByType?.('navigation')[0]; + + if (!navigationTiming?.duration) { + return false; + } + + if (![undefined, 'complete'].includes(document?.readyState)) { + return false; + } + + if (document.querySelector('div[id="success"]')) { + return { state: 'loaded' }; + } + + const errorDiv = document.querySelector('div[id="error"]'); + if (errorDiv) { + return { state: 'error', message: errorDiv.textContent ?? '' }; + } + + return false; +} + +export function getBrowserControllerErrorMessage(error: BrowserControllerErrorType): string { + switch (error) { + case 'browser-creation-failed': + return 'Failed to create browser.'; + case 'browser-context-creation-failed': + return 'Failed to create browser context.'; + case 'page-creation-failed': + return 'Failed to create page.'; + case 'enable-downloads-failed': + return 'Failed to enable downloads.'; + case 'download-failed': + return 'Failed to download files.'; + case 'navigation-failed': + return 'Failed to navigate to the page.'; + case 'page-failed-to-load': + return 'Failed to load the page.'; + case 'viz-load-error': + return 'Failed to load the viz.'; + case 'screenshot-failed': + return 'Failed to take a screenshot of the page.'; + case 'unknown': + return 'Unknown error.'; + } +} diff --git a/src/tools/views/embed.html.ts b/src/tools/views/embed.html.ts new file mode 100644 index 00000000..e491fb4d --- /dev/null +++ b/src/tools/views/embed.html.ts @@ -0,0 +1,82 @@ +export const embedHtml = String.raw` + + + + + + + + + + +`; diff --git a/src/tools/views/getViewData.ts b/src/tools/views/getViewData.ts index a375c6b8..e6b8bcd8 100644 --- a/src/tools/views/getViewData.ts +++ b/src/tools/views/getViewData.ts @@ -1,20 +1,27 @@ import { CallToolResult } from '@modelcontextprotocol/sdk/types.js'; +import { Dashboard, SheetType, Story, TableauViz } from '@tableau/embedding-api'; import { Err, Ok } from 'ts-results-es'; import { z } from 'zod'; import { getConfig } from '../../config.js'; -import { useRestApi } from '../../restApiInstance.js'; import { Server } from '../../server.js'; -import { resourceAccessChecker } from '../resourceAccessChecker.js'; +import { getExceptionMessage } from '../../utils/getExceptionMessage.js'; +import { getJwt, getJwtAdditionalPayload, getJwtSubClaim } from '../../utils/getJwt.js'; import { Tool } from '../tool.js'; +import { + BrowserController, + BrowserControllerError, + getBrowserControllerErrorMessage, + isBrowserControllerErrorType, +} from './browserController.js'; -const paramsSchema = { - viewId: z.string(), -}; +type GetViewDataError = + | BrowserControllerError + | { type: 'invalid-url' | 'embedding-api-not-found'; url: string; error: unknown }; -export type GetViewDataError = { - type: 'view-not-allowed'; - message: string; +const paramsSchema = { + url: z.string(), + sheetName: z.string().optional(), }; export const getGetViewDataTool = (server: Server): Tool => { @@ -28,39 +35,128 @@ export const getGetViewDataTool = (server: Server): Tool => readOnlyHint: true, openWorldHint: false, }, - callback: async ({ viewId }, { requestId }): Promise => { + callback: async ({ url, sheetName }, { requestId }): Promise => { const config = getConfig(); - return await getViewDataTool.logAndExecute({ + return await getViewDataTool.logAndExecute< + Array<{ filename: string; content: string }>, + GetViewDataError + >({ requestId, - args: { viewId }, + args: { url, sheetName }, callback: async () => { - const isViewAllowedResult = await resourceAccessChecker.isViewAllowed({ - viewId, - restApiArgs: { config, requestId, server }, - }); + // const isViewAllowedResult = await resourceAccessChecker.isViewAllowed({ + // viewId, + // restApiArgs: { config, requestId, server }, + // }); + + // if (!isViewAllowedResult.allowed) { + // return new Err({ + // type: 'view-not-allowed', + // message: isViewAllowedResult.message, + // }); + // } - if (!isViewAllowedResult.allowed) { - return new Err({ - type: 'view-not-allowed', - message: isViewAllowedResult.message, + let parsedUrl: URL; + try { + parsedUrl = new URL(url); + } catch (error) { + return Err({ + type: 'invalid-url', + url, + error, }); } - return new Ok( - await useRestApi({ - config, - requestId, - server, - jwtScopes: ['tableau:views:download'], - callback: async (restApi) => { - return await restApi.viewsMethods.queryViewData({ - viewId, - siteId: restApi.siteId, + const embeddingApiUrl = `${parsedUrl.origin}/javascripts/api/tableau.embedding.3.latest.js`; + try { + const response = await fetch(embeddingApiUrl); + if (!response.ok) { + return Err({ + type: 'embedding-api-not-found', + url: embeddingApiUrl, + error: new Error( + `Failed to fetch embedding API JavaScript module: ${response.status} ${response.statusText}`, + ), + }); + } + } catch (error) { + return Err({ + type: 'embedding-api-not-found', + url: embeddingApiUrl, + error, + }); + } + + const token = + parsedUrl.host === 'public.tableau.com' + ? '' + : await getJwt({ + username: getJwtSubClaim(config), + connectedApp: { + clientId: config.connectedAppClientId, + secretId: config.connectedAppSecretId, + secretValue: config.connectedAppSecretValue, + }, + scopes: new Set([ + 'tableau:views:embed', + 'tableau:views:embed_authoring', + 'tableau:insights:embed', + ]), + additionalPayload: getJwtAdditionalPayload(config), }); - }, - }), + + // TODO: https + const embedUrl = `http://localhost:${config.httpPort}/embed#?url=${url}&token=${token}`; + + const result = await BrowserController.create({ headless: !config.useHeadedBrowser }) + .then((b) => b.createNewPage({ width: 800, height: 600 })) + .then((b) => b.enableDownloads()) + .then((b) => b.navigate(embedUrl)) + .then((b) => b.waitForPageLoad()) + .then((b) => b.takeScreenshot()) + .then((b) => b.getResult()); + + if (result.isErr()) { + return result; + } + + const browserController = result.value; + await browserController.page.evaluate( + async ({ sheetName, SheetType }) => { + const viz = document.getElementById('viz') as TableauViz; + const activeSheet = viz.workbook.activeSheet; + if (activeSheet.sheetType === SheetType.Worksheet) { + await viz.exportDataAsync(activeSheet.name); + } else if (activeSheet.sheetType === SheetType.Dashboard) { + if (sheetName) { + await viz.exportDataAsync(sheetName); + } else { + for (const worksheet of (activeSheet as Dashboard).worksheets) { + await viz.exportDataAsync(worksheet.name); + } + } + } else { + const containedSheet = (activeSheet as Story).activeStoryPoint.containedSheet; + if (containedSheet && containedSheet.sheetType === SheetType.Worksheet) { + await viz.exportDataAsync(containedSheet.name); + } else if (containedSheet && containedSheet.sheetType === SheetType.Dashboard) { + if (sheetName) { + await viz.exportDataAsync(sheetName); + } else { + for (const worksheet of (containedSheet as Dashboard).worksheets) { + await viz.exportDataAsync(worksheet.name); + } + } + } + } + }, + { sheetName, SheetType }, ); + + await browserController.waitForDownloads(); + const fileContents = await browserController.getAndDeleteDownloads(); + return Ok(fileContents); }, constrainSuccessResult: (viewData) => { return { @@ -69,10 +165,10 @@ export const getGetViewDataTool = (server: Server): Tool => }; }, getErrorText: (error: GetViewDataError) => { - switch (error.type) { - case 'view-not-allowed': - return error.message; - } + return JSON.stringify({ + reason: getErrorMessage(error), + exception: getExceptionMessage(error.error), + }); }, }); }, @@ -80,3 +176,16 @@ export const getGetViewDataTool = (server: Server): Tool => return getViewDataTool; }; + +function getErrorMessage(error: GetViewDataError): string { + if (isBrowserControllerErrorType(error.type)) { + return getBrowserControllerErrorMessage(error.type); + } + + switch (error.type) { + case 'invalid-url': + return `The URL is invalid: ${error.url}`; + case 'embedding-api-not-found': + return `The Embedding API JavaScript module was not found at ${error.url}.`; + } +} diff --git a/src/tools/views/getViewImage.test.ts b/src/tools/views/getViewImage.test.ts index 39a3b8f8..06426d43 100644 --- a/src/tools/views/getViewImage.test.ts +++ b/src/tools/views/getViewImage.test.ts @@ -59,7 +59,7 @@ describe('getViewImageTool', () => { it('should successfully get view image', async () => { mocks.mockQueryViewImage.mockResolvedValue(mockPngData); - const result = await getToolResult({ viewId: '4d18c547-bbb1-4187-ae5a-7f78b35adf2d' }); + const result = await getToolResult({ url: 'https://example.com' }); expect(result.isError).toBe(false); expect(result.content).toHaveLength(1); expect(result.content[0]).toMatchObject({ @@ -79,7 +79,7 @@ describe('getViewImageTool', () => { it('should handle API errors gracefully', async () => { const errorMessage = 'API Error'; mocks.mockQueryViewImage.mockRejectedValue(new Error(errorMessage)); - const result = await getToolResult({ viewId: '4d18c547-bbb1-4187-ae5a-7f78b35adf2d' }); + const result = await getToolResult({ url: 'https://example.com' }); expect(result.isError).toBe(true); expect(result.content[0].text).toContain(errorMessage); }); @@ -108,7 +108,7 @@ describe('getViewImageTool', () => { }); }); -async function getToolResult(params: { viewId: string }): Promise { +async function getToolResult(params: { url: string }): Promise { const getViewImageTool = getGetViewImageTool(new Server()); return await getViewImageTool.callback(params, { signal: new AbortController().signal, diff --git a/src/tools/views/getViewImage.ts b/src/tools/views/getViewImage.ts index 4ba7492f..cff9e8f1 100644 --- a/src/tools/views/getViewImage.ts +++ b/src/tools/views/getViewImage.ts @@ -3,23 +3,28 @@ import { Err, Ok } from 'ts-results-es'; import { z } from 'zod'; import { getConfig } from '../../config.js'; -import { useRestApi } from '../../restApiInstance.js'; import { Server } from '../../server.js'; -import { convertPngDataToToolResult } from '../convertPngDataToToolResult.js'; -import { resourceAccessChecker } from '../resourceAccessChecker.js'; +import { getExceptionMessage } from '../../utils/getExceptionMessage.js'; +import { getJwt, getJwtAdditionalPayload, getJwtSubClaim } from '../../utils/getJwt.js'; import { Tool } from '../tool.js'; +import { + BrowserController, + BrowserControllerError, + BrowserOptions, + getBrowserControllerErrorMessage, + isBrowserControllerErrorType, +} from './browserController.js'; + +type GetViewImageError = + | BrowserControllerError + | { type: 'invalid-url' | 'embedding-api-not-found'; url: string; error: unknown }; const paramsSchema = { - viewId: z.string(), + url: z.string(), width: z.number().gt(0).optional(), height: z.number().gt(0).optional(), }; -export type GetViewImageError = { - type: 'view-not-allowed'; - message: string; -}; - export const getGetViewImageTool = (server: Server): Tool => { const getViewImageTool = new Tool({ server, @@ -31,42 +36,109 @@ export const getGetViewImageTool = (server: Server): Tool = readOnlyHint: true, openWorldHint: false, }, - callback: async ({ viewId, width, height }, { requestId }): Promise => { + callback: async ({ url, width, height }, { requestId }): Promise => { const config = getConfig(); - return await getViewImageTool.logAndExecute({ + return await getViewImageTool.logAndExecute({ requestId, - args: { viewId }, + args: { url }, callback: async () => { - const isViewAllowedResult = await resourceAccessChecker.isViewAllowed({ - viewId, - restApiArgs: { config, requestId, server }, - }); + // const isViewAllowedResult = await resourceAccessChecker.isViewAllowed({ + // viewId, + // restApiArgs: { config, requestId, server }, + // }); + + // if (!isViewAllowedResult.allowed) { + // return new Err({ + // type: 'view-not-allowed', + // message: isViewAllowedResult.message, + // }); + // } - if (!isViewAllowedResult.allowed) { - return new Err({ - type: 'view-not-allowed', - message: isViewAllowedResult.message, + let parsedUrl: URL; + try { + parsedUrl = new URL(url); + } catch (error) { + return Err({ + type: 'invalid-url', + url, + error, }); } - return new Ok( - await useRestApi({ - config, - requestId, - server, - jwtScopes: ['tableau:views:download'], - callback: async (restApi) => { - return await restApi.viewsMethods.queryViewImage({ - viewId, - siteId: restApi.siteId, - width, - height, - resolution: 'high', + const embeddingApiUrl = `${parsedUrl.origin}/javascripts/api/tableau.embedding.3.latest.js`; + try { + const response = await fetch(embeddingApiUrl); + if (!response.ok) { + return Err({ + type: 'embedding-api-not-found', + url: embeddingApiUrl, + error: new Error( + `Failed to fetch embedding API JavaScript module: ${response.status} ${response.statusText}`, + ), + }); + } + } catch (error) { + return Err({ + type: 'embedding-api-not-found', + url: embeddingApiUrl, + error, + }); + } + + const rendererOptions: BrowserOptions = { + width: width || 800, + height: height || 800, + }; + + const token = + parsedUrl.host === 'public.tableau.com' + ? '' + : await getJwt({ + username: getJwtSubClaim(config), + connectedApp: { + clientId: config.connectedAppClientId, + secretId: config.connectedAppSecretId, + secretValue: config.connectedAppSecretValue, + }, + scopes: new Set([ + 'tableau:views:embed', + 'tableau:views:embed_authoring', + 'tableau:insights:embed', + ]), + additionalPayload: getJwtAdditionalPayload(config), }); + + // TODO: https + const embedUrl = `http://localhost:${config.httpPort}/embed#?url=${url}&token=${token}`; + + const result = await BrowserController.create({ headless: !config.useHeadedBrowser }) + .then((b) => b.createNewPage(rendererOptions)) + .then((b) => b.enableDownloads()) + .then((b) => b.navigate(embedUrl)) + .then((b) => b.waitForPageLoad()) + .then((b) => b.takeScreenshot()) + .then((b) => b.getResult()); + + if (result.isErr()) { + return result; + } + + const { screenshot } = result.value; + return Ok(screenshot); + }, + getSuccessResult: (screenshot: Uint8Array): CallToolResult => { + const base64Data = Buffer.from(screenshot).toString('base64'); + return { + isError: false, + content: [ + { + type: 'image', + data: base64Data, + mimeType: 'image/png', }, - }), - ); + ], + }; }, constrainSuccessResult: (viewImage) => { return { @@ -74,12 +146,11 @@ export const getGetViewImageTool = (server: Server): Tool = result: viewImage, }; }, - getSuccessResult: convertPngDataToToolResult, getErrorText: (error: GetViewImageError) => { - switch (error.type) { - case 'view-not-allowed': - return error.message; - } + return JSON.stringify({ + reason: getErrorMessage(error), + exception: getExceptionMessage(error.error), + }); }, }); }, @@ -87,3 +158,16 @@ export const getGetViewImageTool = (server: Server): Tool = return getViewImageTool; }; + +function getErrorMessage(error: GetViewImageError): string { + if (isBrowserControllerErrorType(error.type)) { + return getBrowserControllerErrorMessage(error.type); + } + + switch (error.type) { + case 'invalid-url': + return `The URL is invalid: ${error.url}`; + case 'embedding-api-not-found': + return `The Embedding API JavaScript module was not found at ${error.url}.`; + } +} diff --git a/src/utils/getJwt.ts b/src/utils/getJwt.ts index 1460d4e0..965556d6 100644 --- a/src/utils/getJwt.ts +++ b/src/utils/getJwt.ts @@ -2,6 +2,8 @@ import { randomUUID } from 'node:crypto'; import { JWTHeaderParameters, JWTPayload, SignJWT } from 'jose'; +import { Config } from '../config.js'; + export async function getJwt({ username, connectedApp, @@ -40,3 +42,12 @@ export async function getJwt({ return token; } + +export function getJwtSubClaim(config: Config): string { + return config.jwtSubClaim; +} + +export function getJwtAdditionalPayload(config: Config): Record { + const json = config.jwtAdditionalPayload; + return JSON.parse(json || '{}'); +} diff --git a/types/process-env.d.ts b/types/process-env.d.ts index 426a3072..9a00d8be 100644 --- a/types/process-env.d.ts +++ b/types/process-env.d.ts @@ -27,6 +27,7 @@ export interface ProcessEnvEx { INCLUDE_PROJECT_IDS: string | undefined; INCLUDE_DATASOURCE_IDS: string | undefined; INCLUDE_WORKBOOK_IDS: string | undefined; + USE_HEADED_BROWSER: string | undefined; } declare global {