feat: add @posthog/convex package (#3077)

* chore: move progress from posthog-convex repo

* Switch from vitest to jest

* fix readme link

* add changeset

* Potential fix for code scanning alert no. 2135: Incomplete string escaping or encoding

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

* fix(convex): stabilize example tests in CI

* fix(react-native): declare missing babel preset-react

* Revert "fix(react-native): declare missing babel preset-react"

This reverts commit 9fe9473. The change was a fix for a
broken test from a different PR, not needed here.

* refactor(convex): move example app to examples/example-convex

Move the Convex example from packages/convex/example/ to the
top-level examples/ directory for consistency with other SDK examples.

- Create standalone package.json with own dependencies
- Exclude test files from convex tsconfig (Convex dev typecheck)
- Update jest config roots and moduleNameMapper to resolve
  @posthog/convex from workspace source for integration tests
- Update convex.json functions path
- Remove example-only devDeps from package (chokidar-cli, react, etc.)

* fix(react-native): declare @babel/preset-react as devDependency

The react-native package uses @babel/preset-react in its babel config
but never declared it explicitly. Also add typescript to convex package's
devDependencies via catalog to prevent lockfile version drift from
cascading to unrelated packages.

* chore(convex): address PR review feedback

- Remove unnecessary client/_generated directory (convex-test finds component/_generated)
- Remove placeholder lib.test.ts
- Use pnpm instead of npm in README install instructions

* fix: regenerate lockfile from main to resolve babel side effects

Reset pnpm-lock.yaml to main and regenerated with only the convex
package dependencies on top, eliminating hoisting changes that were
causing posthog-js-lite build failures on Vercel.

* fix: declare babel presets as explicit devDependencies

Add @babel/preset-env and @babel/preset-typescript to packages that
reference them in babel.config but never declared them. These were
resolving via hoisting, which broke when the dependency tree changed.

---------

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

Author: richardsolomou

.changeset/cold-dogs-allow.md

@@ -0,0 +1,5 @@
+---
+'@posthog/convex': minor
+---
+
+Initial release of @posthog/convex - PostHog analytics integration for Convex

.github/ISSUE_TEMPLATE/bug_report.md

@@ -23,6 +23,7 @@ _Please describe._
 - [ ] posthog-react-native
 - [ ] @posthog/react
 - [ ] @posthog/ai
+- [ ] @posthog/convex
 - [ ] @posthog/nextjs-config
 - [ ] @posthog/nuxt
 - [ ] @posthog/rollup-plugin

.github/ISSUE_TEMPLATE/feature_request.md

@@ -21,6 +21,7 @@ _Please describe._
 - [ ] posthog-react-native
 - [ ] @posthog/react
 - [ ] @posthog/ai
+- [ ] @posthog/convex
 - [ ] @posthog/nextjs-config
 - [ ] @posthog/nuxt
 - [ ] @posthog/rollup-plugin

.github/pull_request_template.md

@@ -19,6 +19,7 @@
 - [ ] posthog-react-native
 - [ ] @posthog/react
 - [ ] @posthog/ai
+- [ ] @posthog/convex
 - [ ] @posthog/nextjs-config
 - [ ] @posthog/nuxt
 - [ ] @posthog/rollup-plugin

.github/workflows/release.yml

@@ -195,6 +195,7 @@ jobs:
                     - name: '@posthog/core'
                     - name: '@posthog/react'
                     - name: '@posthog/ai'
+                    - name: '@posthog/convex'
                     - name: '@posthog/nextjs-config'
                     - name: '@posthog/nuxt'
                     - name: '@posthog/rollup-plugin'

AGENTS.md

@@ -30,6 +30,7 @@ The repository contains the following SDK packages in `./packages/`:
 | `browser/`       | `posthog-js`             | Main browser SDK for capturing events and usage |
 | `web/`           | `posthog-js-lite`        | Lightweight browser SDK                         |
 | `ai/`            | `@posthog/ai`            | AI integrations for Node.js                     |
+| `convex/`        | `@posthog/convex`        | Convex.dev component                            |
 | `node/`          | `posthog-node`           | Node.js backend SDK (requires Node >= 20)       |
 | `react/`         | `@posthog/react`         | React components and hooks                      |
 | `react-native/`  | `posthog-react-native`   | React Native mobile SDK                         |

CHANGELOG.md

@@ -8,4 +8,5 @@ PostHog JS is a mono-repo. The changelogs are in the individual packages
 - [posthog-react-native](./packages/react-native/CHANGELOG.md)
 - [@posthog/react](./packages/react/CHANGELOG.md)
 - [@posthog/ai](./packages/ai/CHANGELOG.md)
+- [@posthog/convex](./packages/convex/CHANGELOG.md)
 - [@posthog/nextjs-config](./packages/nextjs-config/CHANGELOG.md)

README.md

@@ -24,6 +24,7 @@ This is a monorepo containing multiple packages to integrate with Posthog using
 - [posthog-react-native](./packages/react-native/README.md)
 - [@posthog/react](./packages/react/README.md)
 - [@posthog/ai](./packages/ai/README.md)
+- [@posthog/convex](./packages/convex/README.md)
 - [@posthog/nextjs-config](./packages/nextjs-config/README.md)
 - [@posthog/nuxt](./packages/nuxt/README.md)
 - [@posthog/rollup-plugin](./packages/rollup-plugin/README.md)

bin/test

@@ -44,6 +44,7 @@ PACKAGES=(
 # Package display names for the menu
 declare -A PACKAGE_NAMES=(
     ["ai"]="@posthog/ai"
+    ["convex"]="@posthog/convex"
     ["browser"]="posthog-js"
     ["core"]="@posthog/core"
     ["nextjs-config"]="@posthog/nextjs-config"

examples/example-convex/.env.example

@@ -0,0 +1,7 @@
+# Convex deployment (set automatically by `npx convex dev`)
+CONVEX_DEPLOYMENT=
+VITE_CONVEX_URL=
+
+# PostHog (set these on your Convex deployment via `npx convex env set`)
+# npx convex env set POSTHOG_API_KEY phc_your_project_api_key
+# npx convex env set POSTHOG_HOST https://us.i.posthog.com