@paypal/checkout-components 5.0.287 → 5.0.288-alpha.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paypal/checkout-components",
-  "version": "5.0.287",
+  "version": "5.0.288-alpha.21",
   "description": "PayPal Checkout components, for integrating checkout products.",
   "main": "index.js",
   "scripts": {
@@ -110,7 +110,7 @@
     "@krakenjs/zoid": "^10.3.1",
     "@paypal/common-components": "^1.0.35",
     "@paypal/funding-components": "^1.0.31",
-    "@paypal/connect-loader-component": "^1.1.0",
+    "@paypal/connect-loader-component": "1.1.0-beta.1",
     "@paypal/sdk-client": "^4.0.176",
     "@paypal/sdk-constants": "^1.0.133",
     "@paypal/sdk-logos": "^2.2.6"

package/src/hosted-buttons/index.js

@@ -0,0 +1,195 @@
+/* @flow */
+import { ZalgoPromise } from "@krakenjs/zalgo-promise/src";
+import { request, noop } from "@krakenjs/belter/src";
+import { getSDKHost, getClientID, getEnv } from "@paypal/sdk-client/src";
+
+import { getButtonsComponent } from "../zoid/buttons";
+
+type HostedButtonsComponentProps = {|
+  hostedButtonId: string,
+|};
+
+type GetCallbackProps = {|
+  buttonType: string,
+  hostedButtonId: string,
+  merchantId: string,
+|};
+
+type HostedButtonsInstance = {|
+  render: (string | HTMLElement) => void,
+|};
+
+type HostedButtonDetailsParams =
+  (HostedButtonsComponentProps) => ZalgoPromise<{|
+    buttonType: string,
+    merchantId: string,
+    html: string,
+    htmlScript: string,
+    style: {|
+      layout: string,
+      shape: string,
+      color: string,
+      label: string,
+    |},
+  |}>;
+
+type ButtonVariables = $ReadOnlyArray<{|
+  name: string,
+  value: string,
+|}>;
+
+type CreateOrder = (data: {| paymentSource: string |}) => ZalgoPromise<string>;
+
+type OnApprove = (data: {| orderID: string |}) => ZalgoPromise<void>;
+
+export type HostedButtonsComponent =
+  (HostedButtonsComponentProps) => HostedButtonsInstance;
+
+const entryPoint = "SDK";
+const baseUrl = `https://${getSDKHost()}`;
+
+const getHeaders = () => ({
+  Authorization: `Basic ${btoa(getClientID())}`,
+  "Content-Type": "application/json",
+  "PayPal-Entry-Point": entryPoint,
+});
+
+const getButtonVariable = (variables: ButtonVariables, key: string): string =>
+  variables.find((variable) => variable.name === key)?.value ?? "";
+
+const getFundingSource = (paymentSource) => {
+  if (paymentSource === "credit") {
+    return `PAY_WITH_PAYPAL_CREDIT`;
+  }
+  return `PAY_WITH_${paymentSource.toUpperCase()}`;
+};
+
+export const getHostedButtonDetails: HostedButtonDetailsParams = ({
+  hostedButtonId,
+}) => {
+  return request({
+    url: `${baseUrl}/ncp/api/form-fields/${hostedButtonId}`,
+    headers: getHeaders(),
+  }).then(({ body }) => {
+    const variables = body.button_details.button_variables;
+    return {
+      buttonType: getButtonVariable(variables, "button_type"),
+      merchantId: getButtonVariable(variables, "business"),
+      style: {
+        layout: getButtonVariable(variables, "layout"),
+        shape: getButtonVariable(variables, "shape"),
+        color: getButtonVariable(variables, "color"),
+        label: getButtonVariable(variables, "button_text"),
+      },
+      html: body.html,
+      htmlScript: body.html_script,
+    };
+  });
+};
+
+export const getHostedButtonCreateOrder = ({
+  buttonType,
+  hostedButtonId,
+  merchantId,
+}: GetCallbackProps): CreateOrder => {
+  return (data) => {
+    const userInputs = window.__pp_form_fields?.getUserInputs?.() || {};
+    return request({
+      url: `${
+        getEnv() === "local" ? baseUrl : baseUrl.replace("www", "api")
+      }/v1/ncp/orders`,
+      headers: getHeaders(),
+      method: "POST",
+      body: JSON.stringify({
+        button_type: buttonType,
+        entry_point: entryPoint,
+        funding_source: getFundingSource(data.paymentSource),
+        hosted_button_id: hostedButtonId,
+        merchant_id: merchantId,
+        ...userInputs,
+      }),
+    }).then(({ body }) => body.order_id);
+  };
+};
+
+export const getHostedButtonOnApprove = ({
+  buttonType,
+  hostedButtonId,
+  merchantId,
+}: GetCallbackProps): OnApprove => {
+  return (data) => {
+    return request({
+      url: `${baseUrl}/v1/ncp/capture-order`,
+      headers: getHeaders(),
+      method: "POST",
+      body: JSON.stringify({
+        button_type: buttonType,
+        entry_point: entryPoint,
+        hosted_button_id: hostedButtonId,
+        id: data.orderID,
+        merchant_id: merchantId,
+      }),
+    }).then(noop);
+  };
+};
+
+/**
+ * Attaches form fields (html) to the given selector, and
+ * initializes window.__pp_form_fields (htmlScript).
+ */
+const renderForm = ({ html, htmlScript, selector }) => {
+  const elm =
+    typeof selector === "string" ? document.querySelector(selector) : selector;
+  if (elm) {
+    elm.innerHTML = html + htmlScript;
+    const newScriptEl = document.createElement("script");
+    const oldScriptEl = elm.querySelector("script");
+    newScriptEl.innerHTML = oldScriptEl?.innerHTML ?? "";
+    oldScriptEl?.parentNode?.replaceChild(newScriptEl, oldScriptEl);
+  }
+};
+
+export const getHostedButtonsComponent = (): HostedButtonsComponent => {
+  function HostedButtons({
+    hostedButtonId,
+  }: HostedButtonsComponentProps): HostedButtonsInstance {
+    const Buttons = getButtonsComponent();
+    const render = (selector) => {
+      getHostedButtonDetails({ hostedButtonId }).then(
+        ({ buttonType, html, htmlScript, merchantId, style }) => {
+          renderForm({ html, htmlScript, selector });
+
+          // $FlowFixMe
+          Buttons({
+            style,
+            hostedButtonId,
+            onInit(data, actions) {
+              // disable the button, listen for input changes,
+              // and enable the button when the form is valid
+              // using actions.disable() and actions.enable()
+              window.__pp_form_fields?.onInit?.(data, actions);
+            },
+            onClick(data, actions) {
+              // render form errors, if present
+              window.__pp_form_fields?.onClick?.(data, actions);
+            },
+            createOrder: getHostedButtonCreateOrder({
+              buttonType,
+              hostedButtonId,
+              merchantId,
+            }),
+            onApprove: getHostedButtonOnApprove({
+              buttonType,
+              hostedButtonId,
+              merchantId,
+            }),
+          }).render(selector);
+        }
+      );
+    };
+    return {
+      render,
+    };
+  }
+  return HostedButtons;
+};

package/src/hosted-buttons/index.test.js

@@ -0,0 +1,149 @@
+/* @flow */
+
+import { describe, test, expect, vi } from "vitest";
+import { request } from "@krakenjs/belter/src";
+import { ZalgoPromise } from "@krakenjs/zalgo-promise";
+
+import { getButtonsComponent } from "../zoid/buttons";
+
+import {
+  getHostedButtonDetails,
+  getHostedButtonCreateOrder,
+  getHostedButtonOnApprove,
+  getHostedButtonsComponent,
+} from ".";
+
+vi.mock("@krakenjs/belter/src", async () => {
+  return {
+    ...(await vi.importActual("@krakenjs/belter/src")),
+    request: vi.fn(),
+  };
+});
+
+vi.mock("@paypal/sdk-client/src", async () => {
+  return {
+    ...(await vi.importActual("@paypal/sdk-client/src")),
+    getSDKHost: () => "example.com",
+    getClientID: () => "client_id_123",
+  };
+});
+
+vi.mock("../zoid/buttons", async () => {
+  return {
+    ...(await vi.importActual("../zoid/buttons")),
+    getButtonsComponent: vi.fn(),
+  };
+});
+
+const getHostedButtonDetailsResponse = {
+  body: {
+    button_details: {
+      button_variables: [
+        {
+          name: "business",
+          value: "M1234567890",
+        },
+        {
+          name: "shape",
+          value: "rect",
+        },
+        {
+          name: "layout",
+          value: "vertical",
+        },
+        {
+          name: "color",
+          value: "gold",
+        },
+        {
+          name: "button_text",
+          value: "paypal",
+        },
+      ],
+    },
+  },
+};
+
+describe("HostedButtons", () => {
+  test("paypal.Buttons calls getHostedButtonDetails and invokes v5 of the SDK", () => {
+    const Buttons = vi.fn(() => ({ render: vi.fn() }));
+    // $FlowIssue
+    getButtonsComponent.mockImplementationOnce(() => Buttons);
+    const HostedButtons = getHostedButtonsComponent();
+    // $FlowIssue
+    request.mockImplementationOnce(() =>
+      ZalgoPromise.resolve(getHostedButtonDetailsResponse)
+    );
+    HostedButtons({
+      hostedButtonId: "B1234567890",
+    }).render("#example");
+    expect(Buttons).toHaveBeenCalled();
+    expect.assertions(1);
+  });
+
+  test("getHostedButtonDetails", async () => {
+    // $FlowIssue
+    request.mockImplementationOnce(() =>
+      ZalgoPromise.resolve(getHostedButtonDetailsResponse)
+    );
+    await getHostedButtonDetails({
+      hostedButtonId: "B1234567890",
+    }).then(({ merchantId, style }) => {
+      expect(merchantId).toBe("M1234567890");
+      expect(style).toEqual({
+        layout: "vertical",
+        shape: "rect",
+        color: "gold",
+        label: "paypal",
+      });
+    });
+    expect.assertions(2);
+  });
+
+  test("getHostedButtonCreateOrder", async () => {
+    const createOrder = getHostedButtonCreateOrder({
+      buttonType: "FIXED_PRICE",
+      hostedButtonId: "B1234567890",
+      merchantId: "M1234567890",
+    });
+
+    // $FlowIssue
+    request.mockImplementationOnce(() =>
+      ZalgoPromise.resolve({
+        body: {
+          hosted_button_id: "B1234567890",
+          merchant_id: "M1234567890",
+          order_id: "EC-1234567890",
+          status: "PAYER_ACTION_REQUIRED",
+        },
+      })
+    );
+    const orderID = await createOrder({ paymentSource: "paypal" });
+    expect(orderID).toBe("EC-1234567890");
+    expect.assertions(1);
+  });
+
+  test("getHostedButtonOnApprove", async () => {
+    const onApprove = getHostedButtonOnApprove({
+      buttonType: "FIXED_PRICE",
+      hostedButtonId: "B1234567890",
+      merchantId: "M1234567890",
+    });
+
+    // $FlowIssue
+    request.mockImplementationOnce(() => ZalgoPromise.resolve({}));
+    await onApprove({ orderID: "EC-1234567890" });
+    expect(request).toHaveBeenCalledWith(
+      expect.objectContaining({
+        body: JSON.stringify({
+          button_type: "FIXED_PRICE",
+          entry_point: "SDK",
+          hosted_button_id: "B1234567890",
+          id: "EC-1234567890",
+          merchant_id: "M1234567890",
+        }),
+      })
+    );
+    expect.assertions(1);
+  });
+});

package/src/interface/button.js

@@ -33,11 +33,19 @@ import {
   getModalComponent,
   type ModalComponent,
 } from "../zoid/modal/component";
+import {
+  getHostedButtonsComponent,
+  type HostedButtonsComponent,
+} from "../hosted-buttons";
 
 export const Buttons: LazyExport<ButtonsComponent> = {
   __get__: () => getButtonsComponent(),
 };
 
+export const HostedButtons: LazyExport<HostedButtonsComponent> = {
+  __get__: () => getHostedButtonsComponent(),
+};
+
 export const Checkout: LazyProtectedExport<CheckoutComponent> = {
   __get__: () => protectedExport(getCheckoutComponent()),
 };

package/src/zoid/buttons/component.jsx

@@ -834,6 +834,12 @@ export const getButtonsComponent: () => ButtonsComponent = memoize(() => {
         value: getExperimentation,
       },
 
+      hostedButtonId: {
+        type: "string",
+        required: false,
+        queryParam: true,
+      },
+
       displayOnly: {
         type: "array",
         queryParam: true,