Merge branch 'main' into support-308-redirect

Author: Kwok-he-Chu

.github/workflows/codeql-analysis.yml

@@ -4,6 +4,10 @@ on:
   schedule:
     - cron: '0 21 * * 4'
 
+permissions:
+  contents: read
+  security-events: write
+
 jobs:
   CodeQL-Build:
 

.github/workflows/label_new_issues.yml

@@ -3,6 +3,9 @@ on:
   issues:
     types: [opened]
 
+permissions:
+  issues: write
+
 jobs:
   add-label:
     runs-on: ubuntu-latest

.github/workflows/npm-debug.yml

@@ -6,6 +6,9 @@ on:
   release:
     types: [published]
 
+permissions:
+  contents: read
+
 jobs:
   publish-npm:
     runs-on: ubuntu-latest

.github/workflows/npmpublish.yml

@@ -7,6 +7,9 @@ on:
   release:
     types: [published]
 
+permissions:
+  contents: read
+
 jobs:
   publish-npm:
     runs-on: ubuntu-latest

.github/workflows/stale.yml

@@ -3,6 +3,10 @@ on:
   schedule:
     - cron: '30 8 * * *'
 
+permissions:
+  issues: write
+  pull-requests: write
+
 jobs:
   stale:
     runs-on: ubuntu-latest

VERSION

@@ -1 +1 @@
-28.1.0
+29.0.0

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adyen/api-library",
-  "version": "28.1.0",
+  "version": "29.0.0",
   "description": "The Adyen API Library for NodeJS enables you to work with Adyen APIs.",
   "main": "lib/src/index.js",
   "types": "lib/src/index.d.ts",

src/__tests__/webhooks/notification.spec.ts

@@ -141,4 +141,29 @@ describe("Notification Tests", function (): void {
         expect(notificationRequestItem.additionalData["metadata.anotherKey"]).toEqual("anotherValue");
 
     });
+    
+});
+
+describe("NotificationRequestItem.additionalData", () => {
+
+  it("handles undefined keys", () => {
+    const item = new NotificationRequestItem();
+    item.additionalData = {
+        existingKey: "abc",
+        undefinedKey: undefined
+    };
+    item.amount = { currency: "EUR", value: 1000 };
+    item.pspReference = "";
+    item.eventCode = NotificationRequestItem.EventCodeEnum.Authorisation;
+    item.eventDate = "";
+    item.merchantAccountCode = "";
+    item.merchantReference = "";
+    item.success = NotificationRequestItem.SuccessEnum.True;
+
+    expect(item.additionalData).toBeDefined();
+    expect(item.additionalData).toHaveProperty("existingKey", "abc");
+    expect(item.additionalData).toHaveProperty("undefinedKey", undefined);
+    expect(item.additionalData).not.toHaveProperty("nonExistingKey");
+  });
+  
 });

src/services/checkout/modificationsApi.ts

@@ -63,7 +63,7 @@ export class ModificationsApi extends Service {
 
     /**
     * @summary Cancel an authorised payment
-    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment that you want to cancel. 
+    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#responses-200-pspReference) of the payment that you want to cancel. 
     * @param paymentCancelRequest {@link PaymentCancelRequest } 
     * @param requestOptions {@link IRequest.Options }
     * @return {@link PaymentCancelResponse }
@@ -85,7 +85,7 @@ export class ModificationsApi extends Service {
 
     /**
     * @summary Capture an authorised payment
-    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment that you want to capture.
+    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#responses-200-pspReference) of the payment that you want to capture.
     * @param paymentCaptureRequest {@link PaymentCaptureRequest } 
     * @param requestOptions {@link IRequest.Options }
     * @return {@link PaymentCaptureResponse }
@@ -107,7 +107,7 @@ export class ModificationsApi extends Service {
 
     /**
     * @summary Refund a captured payment
-    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment that you want to refund.
+    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#responses-200-pspReference) of the payment that you want to refund.
     * @param paymentRefundRequest {@link PaymentRefundRequest } 
     * @param requestOptions {@link IRequest.Options }
     * @return {@link PaymentRefundResponse }
@@ -129,7 +129,7 @@ export class ModificationsApi extends Service {
 
     /**
     * @summary Refund or cancel a payment
-    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment that you want to reverse. 
+    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#responses-200-pspReference) of the payment that you want to reverse. 
     * @param paymentReversalRequest {@link PaymentReversalRequest } 
     * @param requestOptions {@link IRequest.Options }
     * @return {@link PaymentReversalResponse }
@@ -151,7 +151,7 @@ export class ModificationsApi extends Service {
 
     /**
     * @summary Update an authorised amount
-    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment.
+    * @param paymentPspReference {@link string } The [`pspReference`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#responses-200-pspReference) of the payment.
     * @param paymentAmountUpdateRequest {@link PaymentAmountUpdateRequest } 
     * @param requestOptions {@link IRequest.Options }
     * @return {@link PaymentAmountUpdateResponse }

src/services/checkout/utilityApi.ts

@@ -21,6 +21,8 @@ import { PaypalUpdateOrderRequest } from "../../typings/checkout/models";
 import { PaypalUpdateOrderResponse } from "../../typings/checkout/models";
 import { UtilityRequest } from "../../typings/checkout/models";
 import { UtilityResponse } from "../../typings/checkout/models";
+import { ValidateShopperIdRequest } from "../../typings/checkout/models";
+import { ValidateShopperIdResponse } from "../../typings/checkout/models";
 
 /**
  * API handler for UtilityApi
@@ -97,4 +99,24 @@ export class UtilityApi extends Service {
         return ObjectSerializer.deserialize(response, "PaypalUpdateOrderResponse");
     }
 
+    /**
+    * @summary Validates shopper Id
+    * @param validateShopperIdRequest {@link ValidateShopperIdRequest } 
+    * @param requestOptions {@link IRequest.Options }
+    * @return {@link ValidateShopperIdResponse }
+    */
+    public async validateShopperId(validateShopperIdRequest: ValidateShopperIdRequest, requestOptions?: IRequest.Options): Promise<ValidateShopperIdResponse> {
+        const endpoint = `${this.baseUrl}/validateShopperId`;
+        const resource = new Resource(this, endpoint);
+        
+        const request: ValidateShopperIdRequest = ObjectSerializer.serialize(validateShopperIdRequest, "ValidateShopperIdRequest");
+        const response = await getJsonResponse<ValidateShopperIdRequest, ValidateShopperIdResponse>(
+            resource,
+            request,
+            { ...requestOptions, method: "POST" }
+        );
+
+        return ObjectSerializer.deserialize(response, "ValidateShopperIdResponse");
+    }
+
 }