feat: implement AI styling foundation and billing scope rework

tests/Unit/PackageResourceFeatureLabelTest.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Tests\Unit;
+
+use App\Filament\Resources\PackageResource;
+use Tests\TestCase;
+
+class PackageResourceFeatureLabelTest extends TestCase
+{
+    public function test_it_formats_ai_styling_feature_label_for_display(): void
+    {
+        $formatted = PackageResource::formatFeaturesForDisplay(['ai_styling', 'custom_branding']);
+
+        $this->assertSame('AI-Styling, Eigenes Branding', $formatted);
+    }
+}

tests/Unit/Services/AiStyleAccessServiceTest.php

@@ -0,0 +1,158 @@
+<?php
+
+namespace Tests\Unit\Services;
+
+use App\Models\AiStyle;
+use App\Models\Event;
+use App\Models\EventPackage;
+use App\Models\EventPackageAddon;
+use App\Models\Package;
+use App\Services\AiEditing\AiStyleAccessService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AiStyleAccessServiceTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_package_entitlement_can_use_premium_style(): void
+    {
+        $event = Event::factory()->create();
+        $this->attachPackage($event, ['basic_uploads', 'ai_styling']);
+
+        $style = AiStyle::query()->create([
+            'key' => 'premium-package-style',
+            'name' => 'Premium Package Style',
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'is_active' => true,
+            'is_premium' => true,
+        ]);
+
+        $service = app(AiStyleAccessService::class);
+
+        $this->assertTrue($service->canUseStyle($event->fresh(), $style));
+    }
+
+    public function test_addon_entitlement_cannot_use_premium_style_by_default(): void
+    {
+        $event = Event::factory()->create();
+        $eventPackage = $this->attachPackage($event, ['basic_uploads']);
+        $this->attachAddon($event, $eventPackage);
+
+        $style = AiStyle::query()->create([
+            'key' => 'premium-addon-blocked',
+            'name' => 'Premium Addon Blocked',
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'is_active' => true,
+            'is_premium' => true,
+        ]);
+
+        $service = app(AiStyleAccessService::class);
+
+        $this->assertFalse($service->canUseStyle($event->fresh(), $style));
+    }
+
+    public function test_addon_entitlement_can_use_premium_style_when_style_metadata_allows_it(): void
+    {
+        $event = Event::factory()->create();
+        $eventPackage = $this->attachPackage($event, ['basic_uploads']);
+        $this->attachAddon($event, $eventPackage);
+
+        $style = AiStyle::query()->create([
+            'key' => 'premium-addon-allowed',
+            'name' => 'Premium Addon Allowed',
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'is_active' => true,
+            'is_premium' => true,
+            'metadata' => [
+                'entitlements' => [
+                    'allow_with_addon' => true,
+                ],
+            ],
+        ]);
+
+        $service = app(AiStyleAccessService::class);
+
+        $this->assertTrue($service->canUseStyle($event->fresh(), $style));
+    }
+
+    public function test_required_package_feature_blocks_style_when_missing(): void
+    {
+        $event = Event::factory()->create();
+        $this->attachPackage($event, ['basic_uploads', 'ai_styling']);
+
+        $style = AiStyle::query()->create([
+            'key' => 'advanced-only-style',
+            'name' => 'Advanced Only',
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'is_active' => true,
+            'metadata' => [
+                'entitlements' => [
+                    'required_package_features' => ['advanced_analytics'],
+                ],
+            ],
+        ]);
+
+        $service = app(AiStyleAccessService::class);
+
+        $this->assertFalse($service->canUseStyle($event->fresh(), $style));
+    }
+
+    public function test_required_package_feature_allows_style_when_present(): void
+    {
+        $event = Event::factory()->create();
+        $this->attachPackage($event, ['basic_uploads', 'ai_styling', 'advanced_analytics']);
+
+        $style = AiStyle::query()->create([
+            'key' => 'advanced-available-style',
+            'name' => 'Advanced Available',
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'is_active' => true,
+            'metadata' => [
+                'entitlements' => [
+                    'required_package_features' => ['advanced_analytics'],
+                ],
+            ],
+        ]);
+
+        $service = app(AiStyleAccessService::class);
+
+        $this->assertTrue($service->canUseStyle($event->fresh(), $style));
+    }
+
+    /**
+     * @param  array<int, string>  $features
+     */
+    private function attachPackage(Event $event, array $features): EventPackage
+    {
+        $package = Package::factory()->endcustomer()->create([
+            'features' => $features,
+        ]);
+
+        return EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $package->id,
+            'purchased_price' => $package->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(30),
+        ]);
+    }
+
+    private function attachAddon(Event $event, EventPackage $eventPackage): EventPackageAddon
+    {
+        return EventPackageAddon::query()->create([
+            'event_package_id' => $eventPackage->id,
+            'event_id' => $event->id,
+            'tenant_id' => $event->tenant_id,
+            'addon_key' => 'ai_styling_unlock',
+            'quantity' => 1,
+            'status' => 'completed',
+            'purchased_at' => now(),
+        ]);
+    }
+}

tests/Unit/Services/AiStylingEntitlementServiceTest.php

@@ -0,0 +1,221 @@
+<?php
+
+namespace Tests\Unit\Services;
+
+use App\Models\Event;
+use App\Models\EventPackage;
+use App\Models\EventPackageAddon;
+use App\Models\Package;
+use App\Services\AiEditing\AiStylingEntitlementService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AiStylingEntitlementServiceTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_it_grants_access_via_package_feature(): void
+    {
+        $service = app(AiStylingEntitlementService::class);
+        $event = Event::factory()->create();
+        $package = Package::factory()->endcustomer()->create([
+            'features' => ['basic_uploads', 'ai_styling'],
+        ]);
+
+        EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $package->id,
+            'purchased_price' => $package->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(30),
+        ]);
+
+        $result = $service->resolveForEvent($event->fresh());
+
+        $this->assertTrue($result['allowed']);
+        $this->assertSame('package', $result['granted_by']);
+    }
+
+    public function test_it_grants_access_via_completed_addon(): void
+    {
+        $service = app(AiStylingEntitlementService::class);
+        $event = Event::factory()->create();
+        $package = Package::factory()->endcustomer()->create([
+            'features' => ['basic_uploads'],
+        ]);
+
+        $eventPackage = EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $package->id,
+            'purchased_price' => $package->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(30),
+        ]);
+
+        EventPackageAddon::query()->create([
+            'event_package_id' => $eventPackage->id,
+            'event_id' => $event->id,
+            'tenant_id' => $event->tenant_id,
+            'addon_key' => 'ai_styling_unlock',
+            'quantity' => 1,
+            'status' => 'completed',
+            'purchased_at' => now(),
+        ]);
+
+        $result = $service->resolveForEvent($event->fresh());
+
+        $this->assertTrue($result['allowed']);
+        $this->assertSame('addon', $result['granted_by']);
+    }
+
+    public function test_it_denies_access_without_feature_or_completed_addon(): void
+    {
+        $service = app(AiStylingEntitlementService::class);
+        $event = Event::factory()->create();
+        $package = Package::factory()->endcustomer()->create([
+            'features' => ['basic_uploads'],
+        ]);
+
+        $eventPackage = EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $package->id,
+            'purchased_price' => $package->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(30),
+        ]);
+
+        EventPackageAddon::query()->create([
+            'event_package_id' => $eventPackage->id,
+            'event_id' => $event->id,
+            'tenant_id' => $event->tenant_id,
+            'addon_key' => 'ai_styling_unlock',
+            'quantity' => 1,
+            'status' => 'pending',
+        ]);
+
+        $result = $service->resolveForEvent($event->fresh());
+
+        $this->assertFalse($result['allowed']);
+        $this->assertNull($result['granted_by']);
+    }
+
+    public function test_it_denies_access_when_addon_is_expired_via_metadata(): void
+    {
+        $service = app(AiStylingEntitlementService::class);
+        $event = Event::factory()->create();
+        $package = Package::factory()->endcustomer()->create([
+            'features' => ['basic_uploads'],
+        ]);
+
+        $eventPackage = EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $package->id,
+            'purchased_price' => $package->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(30),
+        ]);
+
+        EventPackageAddon::query()->create([
+            'event_package_id' => $eventPackage->id,
+            'event_id' => $event->id,
+            'tenant_id' => $event->tenant_id,
+            'addon_key' => 'ai_styling_unlock',
+            'quantity' => 1,
+            'status' => 'completed',
+            'purchased_at' => now()->subDays(5),
+            'metadata' => [
+                'entitlements' => [
+                    'features' => ['ai_styling'],
+                    'expires_at' => now()->subDay()->toIso8601String(),
+                ],
+            ],
+        ]);
+
+        $result = $service->resolveForEvent($event->fresh());
+
+        $this->assertFalse($result['allowed']);
+        $this->assertNull($result['granted_by']);
+    }
+
+    public function test_it_uses_latest_event_package_for_upgrade_and_downgrade(): void
+    {
+        $service = app(AiStylingEntitlementService::class);
+        $event = Event::factory()->create();
+
+        $premium = Package::factory()->endcustomer()->create([
+            'features' => ['basic_uploads', 'ai_styling'],
+        ]);
+        $starter = Package::factory()->endcustomer()->create([
+            'features' => ['basic_uploads'],
+        ]);
+
+        EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $premium->id,
+            'purchased_price' => $premium->price,
+            'purchased_at' => now()->subDays(5),
+            'gallery_expires_at' => now()->addDays(30),
+        ]);
+        $latest = EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $starter->id,
+            'purchased_price' => $starter->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(30),
+        ]);
+
+        $resultWithoutAddon = $service->resolveForEvent($event->fresh());
+        $this->assertFalse($resultWithoutAddon['allowed']);
+
+        EventPackageAddon::query()->create([
+            'event_package_id' => $latest->id,
+            'event_id' => $event->id,
+            'tenant_id' => $event->tenant_id,
+            'addon_key' => 'ai_styling_unlock',
+            'quantity' => 1,
+            'status' => 'completed',
+            'purchased_at' => now(),
+        ]);
+
+        $resultWithAddon = $service->resolveForEvent($event->fresh());
+        $this->assertTrue($resultWithAddon['allowed']);
+        $this->assertSame('addon', $resultWithAddon['granted_by']);
+    }
+
+    public function test_it_grants_access_via_metadata_feature_even_with_custom_addon_key(): void
+    {
+        $service = app(AiStylingEntitlementService::class);
+        $event = Event::factory()->create();
+        $package = Package::factory()->endcustomer()->create([
+            'features' => ['basic_uploads'],
+        ]);
+
+        $eventPackage = EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $package->id,
+            'purchased_price' => $package->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(30),
+        ]);
+
+        EventPackageAddon::query()->create([
+            'event_package_id' => $eventPackage->id,
+            'event_id' => $event->id,
+            'tenant_id' => $event->tenant_id,
+            'addon_key' => 'custom_ai_bundle',
+            'quantity' => 1,
+            'status' => 'completed',
+            'purchased_at' => now(),
+            'metadata' => [
+                'entitlements' => [
+                    'features' => ['ai_styling'],
+                ],
+            ],
+        ]);
+
+        $result = $service->resolveForEvent($event->fresh());
+
+        $this->assertTrue($result['allowed']);
+        $this->assertSame('addon', $result['granted_by']);
+    }
+}

tests/Unit/Services/AiUsageLedgerServiceTest.php

@@ -0,0 +1,124 @@
+<?php
+
+namespace Tests\Unit\Services;
+
+use App\Models\AiEditRequest;
+use App\Models\AiStyle;
+use App\Models\Event;
+use App\Models\EventPackage;
+use App\Models\EventPackageAddon;
+use App\Models\Package;
+use App\Models\Photo;
+use App\Services\AiEditing\AiUsageLedgerService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AiUsageLedgerServiceTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_it_records_package_included_context_when_feature_is_in_package(): void
+    {
+        $event = Event::factory()->create();
+        $package = Package::factory()->endcustomer()->create([
+            'features' => ['ai_styling'],
+        ]);
+        EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $package->id,
+            'purchased_price' => $package->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(14),
+        ]);
+
+        $style = AiStyle::query()->create([
+            'key' => 'ledger-style-package',
+            'name' => 'Ledger Package',
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'is_active' => true,
+        ]);
+        $photo = Photo::factory()->for($event)->create([
+            'tenant_id' => $event->tenant_id,
+            'status' => 'approved',
+        ]);
+        $request = AiEditRequest::query()->create([
+            'tenant_id' => $event->tenant_id,
+            'event_id' => $event->id,
+            'photo_id' => $photo->id,
+            'style_id' => $style->id,
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'status' => AiEditRequest::STATUS_SUCCEEDED,
+            'safety_state' => 'passed',
+            'prompt' => 'Package context.',
+            'idempotency_key' => 'ledger-package-context-1',
+            'queued_at' => now(),
+            'completed_at' => now(),
+        ]);
+
+        $ledger = app(AiUsageLedgerService::class)->recordDebitForRequest($request, 0.01234);
+
+        $this->assertSame('package_included', $ledger->package_context);
+        $this->assertSame('0.01234', $ledger->amount_usd);
+        $this->assertSame('runware', $ledger->metadata['provider'] ?? null);
+    }
+
+    public function test_it_records_addon_context_and_is_idempotent_per_request(): void
+    {
+        $event = Event::factory()->create();
+        $package = Package::factory()->endcustomer()->create([
+            'features' => ['basic_uploads'],
+        ]);
+        $eventPackage = EventPackage::query()->create([
+            'event_id' => $event->id,
+            'package_id' => $package->id,
+            'purchased_price' => $package->price,
+            'purchased_at' => now(),
+            'gallery_expires_at' => now()->addDays(14),
+        ]);
+        EventPackageAddon::query()->create([
+            'event_package_id' => $eventPackage->id,
+            'event_id' => $event->id,
+            'tenant_id' => $event->tenant_id,
+            'addon_key' => 'ai_styling_unlock',
+            'quantity' => 1,
+            'status' => 'completed',
+            'purchased_at' => now(),
+        ]);
+
+        $style = AiStyle::query()->create([
+            'key' => 'ledger-style-addon',
+            'name' => 'Ledger Addon',
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'is_active' => true,
+        ]);
+        $photo = Photo::factory()->for($event)->create([
+            'tenant_id' => $event->tenant_id,
+            'status' => 'approved',
+        ]);
+        $request = AiEditRequest::query()->create([
+            'tenant_id' => $event->tenant_id,
+            'event_id' => $event->id,
+            'photo_id' => $photo->id,
+            'style_id' => $style->id,
+            'provider' => 'runware',
+            'provider_model' => 'runware-default',
+            'status' => AiEditRequest::STATUS_SUCCEEDED,
+            'safety_state' => 'passed',
+            'prompt' => 'Addon context.',
+            'idempotency_key' => 'ledger-addon-context-1',
+            'queued_at' => now(),
+            'completed_at' => now(),
+        ]);
+
+        $service = app(AiUsageLedgerService::class);
+        $first = $service->recordDebitForRequest($request, 0.01);
+        $second = $service->recordDebitForRequest($request, 0.99);
+
+        $this->assertSame($first->id, $second->id);
+        $this->assertSame('addon_unlock', $first->package_context);
+        $this->assertSame(1, $request->usageLedgers()->count());
+    }
+}