api/services/nginx/app/tests/Unit/Cron/AutoSendInvoiceThirdBusinessDayTest.php

<?php

use classes\auto_send_invoice_third_business_day_service;
use classes\customer_rule_product_restriction_service;

it('treats a weekday early in the month as not the 3rd business day', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-08-04 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    // 4 Aug 2026 is a Tuesday. The 3rd business day of Aug 2026 is Wed 5 Aug
    // (1=Fri 31 Jul prev month? — actually 1 Aug is a Saturday, so 1=Mon 3 Aug,
    // 2=Tue 4 Aug, 3=Wed 5 Aug). So 4 Aug is the 2nd business day.
    expect($service->isThirdBusinessDay())->toBeFalse();
});

it('identifies the 3rd business day when the month starts on a weekday', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-03 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    // 1 Sep 2026 is a Tuesday. 3rd business day = Thu 3 Sep.
    expect($service->isThirdBusinessDay())->toBeTrue();
});

it('identifies the 3rd business day when the month starts on a weekend', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-08-05 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    // 1 Aug 2026 is a Saturday. 1st business day = Mon 3 Aug, 2nd = Tue 4 Aug, 3rd = Wed 5 Aug.
    expect($service->isThirdBusinessDay())->toBeTrue();
});

it('returns false for the 4th business day of a weekday-starting month', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-04 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    expect($service->isThirdBusinessDay())->toBeFalse();
});

it('returns false for a Saturday even when the day-of-month matches', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-08-01 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    // 1 Aug 2026 is a Saturday. Not a business day at all.
    expect($service->isThirdBusinessDay())->toBeFalse();
});

it('skips configured holidays when computing the 3rd business day', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-03 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    // Force the natural 3rd business day (3 Sep) to be a holiday. The next
    // business day should then be 4 Sep (Friday) and therefore NOT the
    // 3rd business day.
    $service->setHolidayProviderOverride(static fn(): array => ['2026-09-03']);

    expect($service->isThirdBusinessDay())->toBeFalse();
});

it('moves the trigger day forward when the 3rd business day is a holiday', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-04 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    // Force 3 Sep (natural 3rd business day) to be a holiday, so 4 Sep
    // becomes the new 3rd business day.
    $service->setHolidayProviderOverride(static fn(): array => ['2026-09-03']);

    expect($service->isThirdBusinessDay())->toBeTrue();
});

it('exposes a public helper to compute the 3rd business day of any month', function (): void {
    $service = new auto_send_invoice_third_business_day_service();

    // August 2026: weekend-start month -> 3rd business day = Wed 5 Aug.
    expect($service->thirdBusinessDayOfMonth(2026, 8)->format('Y-m-d'))->toBe('2026-08-05');

    // September 2026: weekday-start month -> 3rd business day = Thu 3 Sep.
    expect($service->thirdBusinessDayOfMonth(2026, 9)->format('Y-m-d'))->toBe('2026-09-03');

    // July 2026: starts on Wednesday -> 3rd business day = Fri 3 Jul.
    expect($service->thirdBusinessDayOfMonth(2026, 7)->format('Y-m-d'))->toBe('2026-07-03');
});

it('throws on out-of-range month arguments', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    expect(static fn() => $service->thirdBusinessDayOfMonth(2026, 0))->toThrow(InvalidArgumentException::class);
    expect(static fn() => $service->thirdBusinessDayOfMonth(2026, 13))->toThrow(InvalidArgumentException::class);
    expect(static fn() => $service->thirdBusinessDayOfMonth(1969, 6))->toThrow(InvalidArgumentException::class);
});

it('is a no-op on non-trigger days even when customers are configured', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-01 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );

    $summary = $service->runOnce();

    expect($summary['triggered'])->toBeFalse();
    expect($summary['customers'])->toBe(0);
    expect($summary['jobs_enqueued'])->toBe(0);
    expect($summary['trigger_date'])->toBeNull();
});

it('returns a triggered summary on the 3rd business day with zero customers when none opted in', function (): void {
    $service = new class extends auto_send_invoice_third_business_day_service {
        public function loadEligibleCustomerNumbers(): array
        {
            return [];
        }
        protected function createTransferQueue(): ?\classes\economic_transfer_queue
        {
            return null;
        }
    };
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-03 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );

    $summary = $service->runOnce();

    expect($summary['triggered'])->toBeTrue();
    expect($summary['trigger_date'])->toBe('2026-09-03');
    expect($summary['customers'])->toBe(0);
    expect($summary['collections_scanned'])->toBe(0);
    expect($summary['jobs_enqueued'])->toBe(0);
});

it('counts customers, collections, and enqueued jobs when opted-in customers have ready collections', function (): void {
    $service = new class extends auto_send_invoice_third_business_day_service {
        public function loadEligibleCustomerNumbers(): array
        {
            return [101, 102];
        }
        public function loadReadyInvoiceCollections(array $customerNumbers): array
        {
            return [
                ['id' => 9001, 'customer_number' => 101],
                ['id' => 9002, 'customer_number' => 101],
                ['id' => 9003, 'customer_number' => 102],
            ];
        }
        protected function createTransferQueue(): ?\classes\economic_transfer_queue
        {
            return null; // queue unavailable -> 0 jobs
        }
    };
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-03 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );

    $summary = $service->runOnce();

    expect($summary['triggered'])->toBeTrue();
    expect($summary['customers'])->toBe(2);
    expect($summary['collections_scanned'])->toBe(3);
    expect($summary['jobs_enqueued'])->toBe(0);
    expect($summary['skipped_already_queued'])->toBe(0);
});

it('records a per-collection error when enqueueing throws', function (): void {
    $service = new class extends auto_send_invoice_third_business_day_service {
        public function loadEligibleCustomerNumbers(): array
        {
            return [101];
        }
        public function loadReadyInvoiceCollections(array $customerNumbers): array
        {
            return [
                ['id' => 9001, 'customer_number' => 101],
            ];
        }
        protected function createTransferQueue(): ?\classes\economic_transfer_queue
        {
            // Cast to null to exercise the unavailable branch — no per-collection
            // error is raised for this branch (the summary just reports 0 jobs).
            return null;
        }
    };
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-03 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );

    $summary = $service->runOnce();

    expect($summary['errors'])->toBe([]);
    expect($summary['jobs_enqueued'])->toBe(0);
});

it('clears provider overrides so subsequent calls are not affected', function (): void {
    $service = new auto_send_invoice_third_business_day_service();
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-03 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    expect($service->isThirdBusinessDay())->toBeTrue();

    $service->clearOverrides();

    // After clear, the now provider falls back to wall-clock; we just
    // verify the method still works and the override is gone.
    $service->setNowProviderOverride(
        static fn(): DateTimeImmutable => new DateTimeImmutable('2026-09-04 10:00:00', new DateTimeZone('Europe/Copenhagen'))
    );
    expect($service->isThirdBusinessDay())->toBeFalse();
});

it('exposes the new attribute through the customer-rule service', function (): void {
    expect(customer_rule_product_restriction_service::SUPPORTED_ATTRIBUTES)
        ->toContain(auto_send_invoice_third_business_day_service::ATTRIBUTE);
});

it('uses a stable attribute constant', function (): void {
    expect(auto_send_invoice_third_business_day_service::ATTRIBUTE)
        ->toBe('autoSendInvoiceThirdBusinessDay');
});