Add party field to event with agent/customer values

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: horgh

CHANGELOG.md

@@ -6,6 +6,8 @@ CHANGELOG
 
 * Added `securepay` to the payment processor validation.
 * Added `credit_application` and `fund_transfer` to event type validation.
+* Added the input `/event/party`. This is the party submitting the
+  transaction.
 
 3.3.0 (2025-05-23)
 ------------------

README.md

@@ -154,6 +154,7 @@ $request = $mf->withDevice(
     userAgent: 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.89 Safari/537.36',
     acceptLanguage: 'en-US,en;q=0.8'
 )->withEvent(
+    party: 'customer',
     transactionId: 'txn3134133',
     shopId: 's2123',
     time: '2012-04-12T23:20:50+00:00',

src/MinFraud.php

@@ -306,6 +306,10 @@ public function withDevice(
      *                                            - `recurring_purchase`
      *                                            - `referral`
      *                                            - `survey`
+     * @param string|null          $party         The party submitting the transaction. The valid values
+     *                                            are:
+     *                                            - `agent`
+     *                                            - `customer`
      *
      * @return MinFraud A new immutable MinFraud object. This object is a clone of
      *                  the original with additional data.
@@ -319,13 +323,15 @@ public function withEvent(
         ?string $time = null,
         ?string $transactionId = null,
         ?string $type = null,
+        ?string $party = null,
     ): self {
         if (\count($values) !== 0) {
             if (\func_num_args() !== 1) {
                 throw new \InvalidArgumentException(
                     'You may only provide the $values array or named arguments, not both.',
                 );
             }
+            $party = $this->remove($values, 'party');
             $shopId = $this->remove($values, 'shop_id');
             $time = $this->remove($values, 'time');
             $transactionId = $this->remove($values, 'transaction_id');
@@ -334,6 +340,13 @@ public function withEvent(
             $this->verifyEmpty($values);
         }
 
+        if ($party !== null) {
+            if (!\in_array($party, ['agent', 'customer'], true)) {
+                $this->maybeThrowInvalidInputException("$party is not a valid party");
+            }
+            $values['party'] = $party;
+        }
+
         if ($shopId !== null) {
             $values['shop_id'] = $shopId;
         }

tests/MaxMind/Test/MinFraudTest.php

@@ -136,6 +136,7 @@ public function testFullInsightsRequestUsingNamedArgs(string $class, string $ser
                 domain: 'maxmind.com'
             )
             ->withEvent(
+                party: 'customer',
                 transactionId: 'txn3134133',
                 shopId: 's2123',
                 time: '2014-04-12T23:20:50+00:00',
@@ -1125,6 +1126,39 @@ public function testBadEventType(): void
         )->withEvent(['type' => 'unknown']);
     }
 
+    /**
+     * @dataProvider goodEventParties
+     */
+    public function testGoodEventParty(string $good): void
+    {
+        $this->createMinFraudRequestWithFullResponse(
+            'insights',
+            0
+        )->withEvent(['party' => $good]);
+    }
+
+    /**
+     * @return array<list<string>>
+     */
+    public static function goodEventParties(): array
+    {
+        return [
+            ['agent'],
+            ['customer'],
+        ];
+    }
+
+    public function testBadEventParty(): void
+    {
+        $this->expectException(InvalidInputException::class);
+        $this->expectExceptionMessage('valid party');
+
+        $this->createMinFraudRequestWithFullResponse(
+            'insights',
+            0
+        )->withEvent(['party' => 'unknown']);
+    }
+
     /**
      * @dataProvider badCurrency
      */

tests/data/minfraud/full-request.json

@@ -1,5 +1,6 @@
 {
   "event": {
+    "party": "customer",
     "transaction_id": "txn3134133",
     "shop_id": "s2123",
     "time": "2014-04-12T23:20:50+00:00",