add dockerfile and clean error logging

Author: eiman-eltigani-ttd

docker-compose.yml

@@ -42,3 +42,13 @@ services:
     env_file:
       - .env
 
+  prebid-client-server:
+    build:
+      context: .
+      dockerfile: web-integrations/prebid-integrations/client-server/Dockerfile
+    ports:
+      - "3052:3052"
+    container_name: prebid-client-server
+    env_file:
+      - .env
+

web-integrations/prebid-integrations/client-server/Dockerfile

@@ -0,0 +1,15 @@
+FROM node:20.11.0-alpine3.18
+
+WORKDIR /usr/src/app
+
+# Copy package files first for better caching
+COPY web-integrations/prebid-integrations/client-server/package*.json ./
+RUN npm install
+
+# Copy application files
+COPY web-integrations/prebid-integrations/client-server/server.js ./
+COPY web-integrations/prebid-integrations/client-server/public ./public/
+
+EXPOSE 3052
+CMD ["npm", "start"]
+

web-integrations/prebid-integrations/client-server/README.md

@@ -6,6 +6,45 @@ For the client-side Prebid.js integration example, see [../client-side](../clien
 
 > **NOTE:** While the server side of this example is implemented in JavaScript using Node.js, it is not a requirement. You can use any technology of your choice and refer to this example for illustration of the functionality that needs to be implemented.
 
+## Prerequisites
+
+- **For local testing:** Node.js (version 20.x or later recommended)
+- **For Docker:** Docker and Docker Compose installed
+- UID2 API credentials (API Key and Client Secret)
+- A local UID2 Operator instance **OR** access to the UID2 integration environment
+
+## Run with Docker (Recommended)
+
+### 1. Set Up Environment Variables
+
+Create a `.env` file in the **root of the uid2-examples repository** with the following:
+
+```bash
+# UID2 Operator configuration
+UID2_BASE_URL=http://localhost:8080
+UID2_API_KEY=your-api-key-here
+UID2_CLIENT_SECRET=your-client-secret-here
+```
+
+**For local operator:** Use `UID2_BASE_URL=http://localhost:8080` and your local operator credentials.
+
+**For integration environment:** Use `UID2_BASE_URL=https://operator-integ.uidapi.com` and your portal credentials.
+
+### 2. Build and Run with Docker Compose
+
+From the **root of the uid2-examples repository**, run:
+
+```bash
+docker-compose up prebid-client-server
+```
+
+The application will be available at **`http://localhost:3052`**
+
+To stop the container, press `Ctrl+C` or run:
+
+```bash
+docker-compose down
+```
 
 ## Run Locally for Testing
 
@@ -37,7 +76,7 @@ npm start
 You should see:
 
 ```
-UID2 Prebid Client-Server example listening at http://localhost:3005
+UID2 Prebid Client-Server example listening at http://localhost:3052
 Make sure you have set the following environment variables:
   - UID2_API_KEY
   - UID2_CLIENT_SECRET
@@ -46,7 +85,7 @@ Make sure you have set the following environment variables:
 
 ### 4. Test the Application
 
-1. Open your browser to `http://localhost:3005`
+1. Open your browser to `http://localhost:3052`
 2. Enter an email address in the input field
 3. Click **"Generate UID2"**
 4. You should see:
@@ -89,7 +128,8 @@ Refresh the page - the UID2 token should persist (loaded from localStorage) and
 | `UID2_BASE_URL`      | Yes      | The base URL of the UID2 service. For local testing: `http://localhost:8080`. For integration: `https://operator-integ.uidapi.com`.                  |
 | `UID2_API_KEY`       | Yes      | Your UID2 API key. Must have the GENERATOR role.                                                                                                     |
 | `UID2_CLIENT_SECRET` | Yes      | Your UID2 client secret corresponding to the API key.                                                                                                 |
-| `PORT`               | No       | Port for the Express server (default: 3000). Set to 3005 to avoid conflicts with other examples.                                                     |
+
+**Note:** This application runs on port **3052** by default.
 
 ## How It Works
 

web-integrations/prebid-integrations/client-server/public/index.html

@@ -97,7 +97,6 @@
         const email = $('#email').val();
 
         if (!email) {
-          alert('Please enter an email address');
           return;
         }
 
@@ -115,18 +114,18 @@
 
           const data = await response.json();
 
-          // Check for opt-out (server returns 400 with status: 'optout')
+          // Check for opt-out (server returns 200 with status: 'optout')
+          if (data.status === 'optout') {
+            console.log('UID2 status: optout');
+            localStorage.setItem(UID2_STORAGE_KEY, JSON.stringify({ status: 'optout' }));
+            currentIdentity = null;
+            updateGuiElements();
+            return;
+          }
+
+          // Check for other errors
           if (!response.ok) {
-            if (data.status === 'optout') {
-              console.log('User has opted out');
-              localStorage.setItem(UID2_STORAGE_KEY, JSON.stringify({ status: 'optout' }));
-              currentIdentity = null;
-              updateGuiElements();
-              return;
-            }
-            // Other errors
             console.error('Token generation failed:', data);
-            alert('Failed to generate UID2 token: ' + (data.error || 'Unknown error'));
             return;
           }
 
@@ -146,7 +145,6 @@
 
         } catch (error) {
           console.error('Error calling login endpoint:', error);
-          alert('Failed to generate UID2 token: ' + error.message);
         }
       }
 

web-integrations/prebid-integrations/client-server/server.js

@@ -19,7 +19,7 @@ const express = require('express');
 const crypto = require('crypto');
 
 const app = express();
-const port = process.env.PORT || 3000;
+const port = 3052;
 
 // UID2 API Configuration
 // These values should be set via environment variables for security
@@ -178,7 +178,10 @@ app.post('/login', async (req, res) => {
         );
         const response = decrypt(encryptedResponse.data, uid2ClientSecret, nonce);
 
-        if (response.status !== 'success') {
+        if (response.status === 'optout') {
+            // Opt-out is a valid state, return 200 with status
+            res.json({ status: 'optout' });
+        } else if (response.status !== 'success') {
             res.status(400).json({ error: 'Token generation failed', status: response.status });
         } else if (typeof response.body !== 'object') {
             res.status(400).json({ error: 'Unexpected response format' });