feat: missing

app/Console/Commands/SendEngagementReminderNotifications.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\User;
+use App\Notifications\EngagementReminderNotification;
+use Illuminate\Console\Command;
+use Illuminate\Database\Eloquent\Builder;
+
+class SendEngagementReminderNotifications extends Command
+{
+    protected $signature = 'notifications:send-engagement-reminders
+        {--limit= : Maximum number of users to notify}
+        {--dry-run : Count eligible users without sending notifications}';
+
+    protected $description = 'Send occasional hard-coded engagement reminders to mobile users.';
+
+    public function handle(): int
+    {
+        $limit = $this->limitOption();
+
+        if ($limit === false) {
+            $this->error('The --limit option must be an integer greater than zero.');
+
+            return self::FAILURE;
+        }
+
+        $query = $this->eligibleUsersQuery();
+
+        if ($this->option('dry-run')) {
+            $this->info("{$query->count()} eligible user(s) found.");
+
+            return self::SUCCESS;
+        }
+
+        $sent = 0;
+
+        foreach ($query->lazyById(100) as $user) {
+            if ($limit !== null && $sent >= $limit) {
+                break;
+            }
+
+            $user->notify(
+                new EngagementReminderNotification(EngagementReminderNotification::randomMessageKey()),
+            );
+
+            $sent++;
+        }
+
+        $this->info("{$sent} engagement reminder notification(s) sent.");
+
+        return self::SUCCESS;
+    }
+
+    private function eligibleUsersQuery(): Builder
+    {
+        return User::query()
+            ->select(['id', 'locale', 'suspended_at'])
+            ->whereNull('suspended_at')
+            ->whereHas('deviceTokens')
+            ->whereDoesntHave('mealPosts', fn (Builder $query): Builder => $query
+                ->where('created_at', '>=', now()->subDay()));
+    }
+
+    private function limitOption(): int|false|null
+    {
+        $limit = $this->option('limit');
+
+        if ($limit === null || $limit === '') {
+            return null;
+        }
+
+        return filter_var($limit, FILTER_VALIDATE_INT, [
+            'options' => ['min_range' => 1],
+        ]);
+    }
+}

app/Notifications/EngagementReminderNotification.php

@@ -0,0 +1,100 @@
+<?php
+
+namespace App\Notifications;
+
+use App\Services\MobileDeepLink;
+use Illuminate\Bus\Queueable;
+use Illuminate\Notifications\Notification;
+use Illuminate\Support\Arr;
+
+class EngagementReminderNotification extends Notification
+{
+    use Queueable;
+
+    private const MESSAGE_KEYS = [
+        'publish_meal',
+        'meal_photo',
+        'evening_checkin',
+        'community_inspiration',
+        'workout_checkin',
+    ];
+
+    public function __construct(private readonly string $messageKey) {}
+
+    public static function randomMessageKey(): string
+    {
+        return Arr::random(self::MESSAGE_KEYS);
+    }
+
+    /**
+     * @return list<string>
+     */
+    public static function messageKeys(): array
+    {
+        return self::MESSAGE_KEYS;
+    }
+
+    /**
+     * Get the notification's delivery channels.
+     *
+     * @return array<int, string>
+     */
+    public function via(object $notifiable): array
+    {
+        return ['expo'];
+    }
+
+    /**
+     * @return array{
+     *     title: string,
+     *     body: string,
+     *     sound: string,
+     *     channelId: string,
+     *     data: array{type: string, message_key: string, url: string}
+     * }
+     */
+    public function toExpoPush(object $notifiable): array
+    {
+        $message = $this->message();
+
+        return [
+            'title' => $message['title'],
+            'body' => $message['body'],
+            'sound' => 'default',
+            'channelId' => 'default',
+            'data' => [
+                'type' => 'engagement_reminder',
+                'message_key' => $this->messageKey,
+                'url' => MobileDeepLink::to($this->path()),
+            ],
+        ];
+    }
+
+    /**
+     * @return array{title: string, body: string}
+     */
+    private function message(): array
+    {
+        $message = trans("api.notifications.engagement_reminders.{$this->messageKey}");
+
+        if (is_array($message)) {
+            return $message;
+        }
+
+        $fallback = trans('api.notifications.engagement_reminders.publish_meal');
+
+        return is_array($fallback)
+            ? $fallback
+            : [
+                'title' => 'Bowli',
+                'body' => 'Publie ton plat du jour quand tu as un moment.',
+            ];
+    }
+
+    private function path(): string
+    {
+        return $this->messageKey === 'workout_checkin'
+            ? 'profile/workouts?create=1'
+            : 'create';
+    }
+}

app/Services/MobileDeepLink.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Services;
+
+class MobileDeepLink
+{
+    /**
+     * @param  array<string, mixed>  $query
+     */
+    public static function to(string $path, array $query = []): string
+    {
+        $url = sprintf('%s://%s', self::scheme(), ltrim($path, '/'));
+        $queryString = http_build_query($query, '', '&', PHP_QUERY_RFC3986);
+
+        return $queryString === ''
+            ? $url
+            : "{$url}?{$queryString}";
+    }
+
+    private static function scheme(): string
+    {
+        $scheme = rtrim((string) config('app.mobile_scheme', 'bowly'), ':/');
+
+        return $scheme !== '' ? $scheme : 'bowly';
+    }
+}