Add multiple language support for Standard & Advanced Integration (#152)

.devcontainer/advanced-integration-v1/devcontainer.json

@@ -37,4 +37,4 @@
       }
     }
   }
-}
+}

.devcontainer/advanced-integration-v2/devcontainer.json

@@ -6,15 +6,19 @@
   // Use 'onCreateCommand' to run commands when creating the container.
   "onCreateCommand": "bash ../../.devcontainer/advanced-integration-v2/welcome-message.sh",
   // Use 'postCreateCommand' to run commands after the container is created.
-  "postCreateCommand": "npm install",
+  "postCreateCommand": {
+    "Install Server Packages": "cd server/node && npm install",
+    "Install Client Packages": "cd client/html && npm install"
+  },
   // Use 'postAttachCommand' to run commands when attaching to the container.
   "postAttachCommand": {
-    "Start server": "npm start"
+    "Start server": "cd server/node && npm start",
+    "Start client": "cd client/html && npm start"
   },
   // Use 'forwardPorts' to make a list of ports inside the container available locally.
-  "forwardPorts": [8888],
+  "forwardPorts": [3000, 8080],
   "portsAttributes": {
-    "8888": {
+    "3000": {
       "label": "Preview of Advanced Checkout Flow",
       "onAutoForward": "openBrowserOnce"
     }

.devcontainer/standard-integration/devcontainer.json

@@ -6,15 +6,19 @@
   // Use 'onCreateCommand' to run commands when creating the container.
   "onCreateCommand": "bash ../.devcontainer/standard-integration/welcome-message.sh",
   // Use 'postCreateCommand' to run commands after the container is created.
-  "postCreateCommand": "npm install",
+  "postCreateCommand": {
+    "Install Client Packages": "cd client/html && npm install",
+    "Install Server Packages": "cd server/node && npm install"
+  },
   // Use 'postAttachCommand' to run commands when attaching to the container.
   "postAttachCommand": {
-    "Start server": "npm start"
+    "Start client": "cd client/html && npm start",
+    "Start server": "cd server/node && npm start"
   },
   // Use 'forwardPorts' to make a list of ports inside the container available locally.
-  "forwardPorts": [8888],
+  "forwardPorts": [3000, 8080],
   "portsAttributes": {
-    "8888": {
+    "3000": {
       "label": "Preview of Standard Checkout Flow",
       "onAutoForward": "openBrowserOnce"
     }

.gitignore

@@ -99,3 +99,6 @@ dist
 
 # TernJS port file
 .tern-port
+
+# dotnet
+*.sln

advanced-integration/v2/client/html/.env.example

@@ -0,0 +1,4 @@
+# Create an application to obtain credentials at
+# https://developer.paypal.com/dashboard/applications/sandbox
+
+PAYPAL_CLIENT_ID=YOUR_CLIENT_ID_GOES_HERE

advanced-integration/v2/client/html/.gitignore

@@ -0,0 +1,2 @@
+node_modules
+*.local

advanced-integration/v2/client/html/README.md

@@ -0,0 +1,74 @@
+# Advanced Integration with PayPal : HTML/JS
+
+## Getting Started
+
+This guide will walk you through setting up and running the HTML/JS Advanced Integration locally.
+
+### Before You Code
+
+1. **Setup a PayPal Account**
+
+   To get started, you'll need a developer, personal, or business account.
+
+   [Sign Up](https://www.paypal.com/signin/client?flow=provisionUser) or [Log In](https://www.paypal.com/signin?returnUri=https%253A%252F%252Fdeveloper.paypal.com%252Fdashboard&intent=developer)
+
+   You'll then need to visit the [Developer Dashboard](https://developer.paypal.com/dashboard/) to obtain credentials and to make sandbox accounts.
+
+2. **Create an Application**
+
+   Once you've setup a PayPal account, you'll need to obtain a **Client ID** and **Secret**. [Create a sandbox application](https://developer.paypal.com/dashboard/applications/sandbox/create).
+
+### Installation
+
+```sh
+npm install
+```
+
+### Configuration
+
+1. Environmental Variables (.env)
+
+    - Rename the .env.example file to .env
+    - Update the following keys with their actual values -
+
+      ```sh
+      PAYPAL_CLIENT_ID=<PAYPAL_CLIENT_ID>
+      ```
+
+2. Connecting the client and server (vite.config.js)
+
+    - Open vite.config.js in the root directory.
+    - Locate the proxy configuration object.
+    - Update the proxy key to match the server's address and port. For example:
+
+        ```js
+            export default defineConfig({
+
+                server: {
+                    proxy: {
+                        "/api": {
+                            target: "http://localhost:8080", // Replace with your server URL
+                            changeOrigin: true,
+                        },
+                    },
+                },
+            });
+        ```
+
+3. Starting the development server
+
+    - **Start the server**: Follow the instructions in the server's README to start it. Typically, this involves running npm run dev or a similar command in the server directory.
+
+    - **Start the client**:
+
+        ```sh
+            npm run dev
+        ```
+
+        This will start the development server, and you should be able to access the Advanced Checkout Page in your browser at `http://localhost:3000` (or the port specfied in the terminal output).
+
+### Additional Notes
+
+- **Server Setup**: Make sure you have the server up and running before starting the client.
+- **Environment Variables**: Carefully configure the environment variables in the .env file to match your setup.
+- **Proxy Configuration**: The proxy setting in vite.config.js is crucial for routing API requests from the client to the server during development.