{"_id":"@antonvishal/browserbase-tracking-kit","name":"@antonvishal/browserbase-tracking-kit","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@antonvishal/browserbase-tracking-kit","version":"0.1.0","description":"bbdash CLI and local dashboard for Browserbase tracking","keywords":["browserbase","bbdash","observability","dashboard","cli","postgresql","nodejs","bun"],"author":{"name":"Anton Vishal"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/antonvishal/browserbase-dashboard.git","directory":"packages/browserbase-tracking-kit"},"homepage":"https://github.com/antonvishal/browserbase-dashboard#readme","bugs":{"url":"https://github.com/antonvishal/browserbase-dashboard/issues"},"type":"module","sideEffects":false,"engines":{"node":">=22","bun":">=1.2.0"},"publishConfig":{"access":"public"},"bin":{"bbdash":"dist/cli.mjs"},"module":"./dist/index.mjs","types":"./dist/index.d.mts","exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs"},"./plans":{"types":"./dist/plans.d.mts","import":"./dist/plans.mjs"}},"scripts":{"build":"bun run build:dashboard && tsdown","build:dashboard":"vite build --config dashboard/vite.config.ts","dev:ui":"vite --config dashboard/vite.config.ts","typecheck":"tsc --noEmit && tsc --noEmit -p dashboard/tsconfig.json","test":"bun test ./test/*.test.ts","check":"bun run typecheck && bun run test && bun run build","prepack":"bun run check"},"dependencies":{"@hono/node-server":"^2.0.10","commander":"^15.0.0","hono":"^4.12.30","jiti":"^2.7.0","open":"^11.0.0","postgres":"^3.4.9"},"devDependencies":{"@types/bun":"^1.3.14","@types/node":"^26.1.1","@types/react":"^19.2.17","@types/react-dom":"^19.2.3","@vitejs/plugin-react":"^6.0.3","lucide-react":"^1.24.0","react":"^19.2.7","react-dom":"^19.2.7","tsdown":"^0.22.8","typescript":"^5.9.3","vite":"^8.1.4"},"gitHead":"dce2c2aec8e976acf13acf319e159fcb93c05e68","_id":"@antonvishal/browserbase-tracking-kit@0.1.0","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-+zbdyVkVP7Txxt+gJCkoLZk54bYU25chYLo6BIuDbX6h4UxHMwcP//mVqMC9Sj+rGif5GD1nOwUO/TX36N/fWg==","shasum":"0295a6271099350456fcd1bb5c5a35e72a0d9706","tarball":"https://registry.npmjs.org/@antonvishal/browserbase-tracking-kit/-/browserbase-tracking-kit-0.1.0.tgz","fileCount":19,"unpackedSize":359742,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDz4clbWs2ldaF1igd/5lKIRTIp76CY/bqlqYPmPSWN3wIgSykyfTfQrlXYKTav2idNNTxIDBrXJH3Q2hxJpKdmopQ="}]},"_npmUser":{"name":"antonvishal","email":"vishalanton@appexert.com"},"directories":{},"maintainers":[{"name":"antonvishal","email":"vishalanton@appexert.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/browserbase-tracking-kit_0.1.0_1784217659975_0.24334380246115228"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-16T16:00:59.628Z","0.1.0":"2026-07-16T16:01:00.154Z","modified":"2026-07-16T16:01:00.389Z"},"maintainers":[{"name":"antonvishal","email":"vishalanton@appexert.com"}],"description":"bbdash CLI and local dashboard for Browserbase tracking","homepage":"https://github.com/antonvishal/browserbase-dashboard#readme","keywords":["browserbase","bbdash","observability","dashboard","cli","postgresql","nodejs","bun"],"repository":{"type":"git","url":"git+https://github.com/antonvishal/browserbase-dashboard.git","directory":"packages/browserbase-tracking-kit"},"author":{"name":"Anton Vishal"},"bugs":{"url":"https://github.com/antonvishal/browserbase-dashboard/issues"},"license":"MIT","readme":"# @antonvishal/browserbase-tracking-kit\n\n> Early-stage, community-maintained software. Not affiliated with or endorsed by\n> Browserbase.\n\nCompanion tooling for `@antonvishal/browserbase-tracking`: configuration loading,\nthe `bbdash` CLI, and the bundled read-only local dashboard. It has no role\nin tracking writes and does not depend on the runtime package.\n\nRequires **Node.js 22+** or **Bun 1.2+**. The CLI shebang uses Node; Bun can\nstill run `bbdash` through its Node-compatible path.\n\n```bash\nnpm add -D @antonvishal/browserbase-tracking-kit\n# or\nbun add -d @antonvishal/browserbase-tracking-kit\n```\n\nCreate `browserbase.config.ts` in the project root:\n\n```ts\nimport { defineConfig } from \"@antonvishal/browserbase-tracking-kit\";\n\nexport default defineConfig({\n  dbCredentials: {\n    url: process.env.DATABASE_URL!,\n  },\n  dashboard: {\n    port: 4321,\n    open: true,\n  },\n});\n```\n\nDeclare the documented tracking tables and views in your application's Drizzle\nschema, provision them through your application's migration workflow, then\nlaunch the dashboard. The runtime package ships the complete copyable schema at\n`node_modules/@antonvishal/browserbase-tracking/examples/schema.ts`:\n\n```bash\nnpx bbdash dash\n# or\nbunx bbdash dash\n```\n\nResolution order is `--database-url`, `browserbase.config.ts`, then `DATABASE_URL`. CLI options override config values:\n\n```text\n--config <path>       Config file (default: browserbase.config.ts)\n--database-url <url>  Override dbCredentials.url\n--port <port>         Override dashboard.port\n--no-open             Disable automatic browser opening\n```\n\nOne process binds only to `127.0.0.1` and serves both the SPA and its validated,\nread-only `/api/v1` HTTP interface. It validates the tracking schema version before listening;\nit never creates or migrates them.\n\nThe dashboard displays stored Search queries and results, Fetch URLs and\ncontent, response headers, and error details. Treat local access as access to\nthe underlying tracking database. The server intentionally binds only to the\nloopback interface and has no authentication; do not proxy or expose it to a\nnetwork.\n\n## License\n\nMIT. Browserbase is a trademark of its respective owner; use of the name here\nonly describes compatibility.\n","readmeFilename":"README.md","_rev":"1-f2cf1b658d2035fc240f5fb16e27a8c6"}