From 2c50a60790a69e7e2046fa93725f6e5482fadc95 Mon Sep 17 00:00:00 2001 From: Paulo Castellano Date: Fri, 24 Jul 2026 11:44:47 -0300 Subject: [PATCH] Capture post.created to PostHog with created_via. Dispatch TrackPost from PostCreated so we can chart which entry points create the most posts. Co-authored-by: Cursor --- app/Enums/PostHog/PostEvent.php | 10 ++ app/Jobs/PostHog/TrackPost.php | 67 +++++++++++++ app/Listeners/PostHog/TrackPostCreated.php | 21 ++++ tests/Feature/Jobs/PostHog/TrackPostTest.php | 96 +++++++++++++++++++ .../PostHog/TrackPostCreatedTest.php | 71 ++++++++++++++ 5 files changed, 265 insertions(+) create mode 100644 app/Enums/PostHog/PostEvent.php create mode 100644 app/Jobs/PostHog/TrackPost.php create mode 100644 app/Listeners/PostHog/TrackPostCreated.php create mode 100644 tests/Feature/Jobs/PostHog/TrackPostTest.php create mode 100644 tests/Feature/Listeners/PostHog/TrackPostCreatedTest.php diff --git a/app/Enums/PostHog/PostEvent.php b/app/Enums/PostHog/PostEvent.php new file mode 100644 index 00000000..e67b1e30 --- /dev/null +++ b/app/Enums/PostHog/PostEvent.php @@ -0,0 +1,10 @@ +onQueue('posthog'); + } + + public function handle(PostHogService $postHog): void + { + if (! PostHogService::isEnabled()) { + return; + } + + $post = Post::query() + ->with(['workspace.account.plan', 'user']) + ->find($this->postId); + + if (! $post) { + return; + } + + $account = $post->workspace?->account; + + if (! $account) { + return; + } + + $distinctId = (string) ($post->user_id ?? $account->owner_id); + + if ($distinctId === '') { + return; + } + + $postHog->capture( + $distinctId, + PostEvent::Created->value, + [ + 'post_id' => (string) $post->id, + 'workspace_id' => (string) $post->workspace_id, + 'created_via' => $post->created_via?->value, + 'status' => $post->status->value, + ], + $account, + ); + } +} diff --git a/app/Listeners/PostHog/TrackPostCreated.php b/app/Listeners/PostHog/TrackPostCreated.php new file mode 100644 index 00000000..eab05d0e --- /dev/null +++ b/app/Listeners/PostHog/TrackPostCreated.php @@ -0,0 +1,21 @@ +post->id); + } +} diff --git a/tests/Feature/Jobs/PostHog/TrackPostTest.php b/tests/Feature/Jobs/PostHog/TrackPostTest.php new file mode 100644 index 00000000..350042a8 --- /dev/null +++ b/tests/Feature/Jobs/PostHog/TrackPostTest.php @@ -0,0 +1,96 @@ + true, 'services.posthog.api_key' => 'phc_test_key']); + + $this->account = Account::factory()->create(); + $this->user = User::factory()->create(['account_id' => $this->account->id]); + $this->account->update(['owner_id' => $this->user->id]); + $this->workspace = Workspace::factory()->create([ + 'account_id' => $this->account->id, + 'user_id' => $this->user->id, + ]); +}); + +test('job is queued on the posthog queue', function () { + $job = new TrackPost((string) Str::uuid()); + + expect($job->queue)->toBe('posthog'); +}); + +test('handle captures post.created with created_via and account group', function () { + Queue::fake(); + + $post = Post::factory()->create([ + 'workspace_id' => $this->workspace->id, + 'user_id' => $this->user->id, + 'created_via' => CreatedVia::Api, + ]); + + (new TrackPost((string) $post->id))->handle(app(PostHogService::class)); + + Queue::assertPushed(SendEvent::class, function ($job) use ($post) { + return $job->method === 'capture' + && $job->payload['event'] === PostEvent::Created->value + && $job->payload['distinctId'] === (string) $this->user->id + && $job->payload['properties']['post_id'] === (string) $post->id + && $job->payload['properties']['workspace_id'] === (string) $this->workspace->id + && $job->payload['properties']['created_via'] === CreatedVia::Api->value + && $job->payload['properties']['$groups']['account'] === (string) $this->account->id; + }); +}); + +test('handle falls back to account owner when post has no user', function () { + Queue::fake(); + + $post = Post::factory()->create([ + 'workspace_id' => $this->workspace->id, + 'user_id' => null, + 'created_via' => CreatedVia::Mcp, + ]); + + (new TrackPost((string) $post->id))->handle(app(PostHogService::class)); + + Queue::assertPushed( + SendEvent::class, + fn ($job) => $job->payload['distinctId'] === (string) $this->user->id + && $job->payload['properties']['created_via'] === CreatedVia::Mcp->value, + ); +}); + +test('handle returns silently when post does not exist', function () { + Queue::fake(); + + (new TrackPost((string) Str::uuid()))->handle(app(PostHogService::class)); + + Queue::assertNothingPushed(); +}); + +test('handle does not push when PostHog is disabled', function () { + config(['services.posthog.api_key' => null]); + Queue::fake(); + + $post = Post::factory()->create([ + 'workspace_id' => $this->workspace->id, + 'user_id' => $this->user->id, + 'created_via' => CreatedVia::Web, + ]); + + (new TrackPost((string) $post->id))->handle(app(PostHogService::class)); + + Queue::assertNotPushed(SendEvent::class); +}); diff --git a/tests/Feature/Listeners/PostHog/TrackPostCreatedTest.php b/tests/Feature/Listeners/PostHog/TrackPostCreatedTest.php new file mode 100644 index 00000000..311d39c1 --- /dev/null +++ b/tests/Feature/Listeners/PostHog/TrackPostCreatedTest.php @@ -0,0 +1,71 @@ + true, 'services.posthog.api_key' => 'phc_test_key']); + + $this->account = Account::factory()->create(); + $this->user = User::factory()->create(['account_id' => $this->account->id]); + $this->account->update(['owner_id' => $this->user->id]); + $this->workspace = Workspace::factory()->create([ + 'account_id' => $this->account->id, + 'user_id' => $this->user->id, + ]); +}); + +test('listener dispatches TrackPost with the post id', function () { + $post = Post::factory()->create([ + 'workspace_id' => $this->workspace->id, + 'user_id' => $this->user->id, + 'created_via' => CreatedVia::Web, + ]); + + Bus::fake(); + + (new TrackPostCreated)->handle(new PostCreated($post)); + + Bus::assertDispatched( + TrackPost::class, + fn ($job) => $job->postId === (string) $post->id, + ); +}); + +test('listener is wired to the PostCreated event via auto-discovery', function () { + $post = Post::factory()->create([ + 'workspace_id' => $this->workspace->id, + 'user_id' => $this->user->id, + 'created_via' => CreatedVia::Automation, + ]); + + Bus::fake(); + + PostCreated::dispatch($post); + + Bus::assertDispatched(TrackPost::class); +}); + +test('listener does not dispatch when PostHog is disabled', function () { + config(['services.posthog.enabled' => false]); + + $post = Post::factory()->create([ + 'workspace_id' => $this->workspace->id, + 'user_id' => $this->user->id, + ]); + + Bus::fake(); + + (new TrackPostCreated)->handle(new PostCreated($post)); + + Bus::assertNotDispatched(TrackPost::class); +});