Add event party field to support agent and customer transactions

Add EventParty enum with Agent and Customer values. Update Event class
to include party field as the first property per requirements. Updated
tests and documentation to demonstrate usage.

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

Co-Authored-By: Claude <[email protected]>

Author: horgh

CHANGELOG.md

@@ -6,6 +6,8 @@ CHANGELOG
 
 * Added `Securepay` to the `Processor` enum.
 * Added `CreditApplication` and `FundTransfer` to the `EventType` enum.
+* Added the input `/event/party`. This is the party submitting the
+  transaction. You may provide this by providing `party` to `Event`.
 
 8.1.0 (2025-05-23)
 ------------------

README.md

@@ -181,6 +181,7 @@ try {
       ipAddress: "81.2.69.160",
     }),
     event: new minFraud.Event({
+      party: minFraud.Constants.EventParty.Customer,
       shopId: 'shop',
       time: new Date(Date.now()),
       transactionId: 'txn1234',

src/constants.ts

@@ -1,3 +1,8 @@
+export enum EventParty {
+  Agent = 'agent',
+  Customer = 'customer',
+}
+
 export enum EventType {
   AccountCreation = 'account_creation',
   AccountLogin = 'account_login',

src/request/event.spec.ts

@@ -1,5 +1,5 @@
 import Event from './event';
-import { EventType } from '../constants';
+import { EventParty, EventType } from '../constants';
 
 describe('Event()', () => {
   it('sets `time` to now by default', () => {
@@ -31,4 +31,20 @@ describe('Event()', () => {
 
     expect(event.type).toEqual(EventType.FundTransfer);
   });
+
+  it('accepts agent party', () => {
+    const event = new Event({
+      party: EventParty.Agent,
+    });
+
+    expect(event.party).toEqual(EventParty.Agent);
+  });
+
+  it('accepts customer party', () => {
+    const event = new Event({
+      party: EventParty.Customer,
+    });
+
+    expect(event.party).toEqual(EventParty.Customer);
+  });
 });

src/request/event.ts

@@ -1,6 +1,10 @@
-import { EventType } from '../constants';
+import { EventParty, EventType } from '../constants';
 
 interface EventProps {
+  /**
+   * The party submitting the transaction.
+   */
+  party?: EventParty;
   /**
    * Your internal ID for the transaction. We can use this to locate a specific
    * transaction in our logs, and it will also show up in email alerts and
@@ -27,13 +31,15 @@ interface EventProps {
  * Event information for the transaction being sent to the web service.
  */
 export default class Event implements EventProps {
+  /** @inheritDoc EventProps.party */
+  public party?: EventParty;
   /** @inheritDoc EventProps.transactionId */
   public transactionId?: string;
   /** @inheritDoc EventProps.shopId */
   public shopId?: string;
   /** @inheritDoc EventProps.time */
   public time?: Date;
-  /** @inheritDoc EventProps.EventType */
+  /** @inheritDoc EventProps.type */
   public type?: EventType;
 
   public constructor(minfraudEvent: EventProps) {