testSetup

.env.example

@@ -1,5 +1,43 @@
+# AWS S3 Configuration (existing)
 S3_BUCKET=
 S3_REGION=
 S3_ACCESS_KEY_ID=
 S3_SECRET_ACCESS_KEY=
 S3_CLOUDFRONT_DISTRIBUTION_ID=
+
+# OpenSIPS-JS Testing Framework Environment Configuration
+
+# Test execution
+SAMPLETOEXECUTE=tests2/samples/e2e/sample.json
+PORT=5173
+
+# GIGAPIPE Configuration for qryn integration
+# DEFAULT configuration is used as fallback for all services if no specific config provided
+
+# Default configuration (fallback for all services)
+GIGAPIPE.DEFAULT.url=https://your-qryn-instance.com
+GIGAPIPE.DEFAULT.scope=test
+GIGAPIPE.DEFAULT.headers.Authorization=Bearer your-token
+GIGAPIPE.DEFAULT.headers.X-Scope-OrgID=your-org-id
+
+# Service-specific overrides (optional)
+# GIGAPIPE.TRACING.url=https://your-qryn-tracing.com
+# GIGAPIPE.TRACING.scope=tracing
+# GIGAPIPE.TRACING.headers.Authorization=Bearer your-tracing-token
+
+# GIGAPIPE.METRICS.url=https://your-qryn-metrics.com
+# GIGAPIPE.METRICS.scope=metrics
+# GIGAPIPE.METRICS.headers.Authorization=Bearer your-metrics-token
+
+# GIGAPIPE.LOGS.url=https://your-qryn-logs.com
+# GIGAPIPE.LOGS.scope=logs
+# GIGAPIPE.LOGS.headers.Authorization=Bearer your-logs-token
+
+# SIP test parameters
+PARAMETERS.CALLER.sip_domain=your-sip-domain.com
+PARAMETERS.CALLER.username=caller
+PARAMETERS.CALLER.password=your-password
+
+PARAMETERS.CALLEE.sip_domain=your-sip-domain.com
+PARAMETERS.CALLEE.username=callee
+PARAMETERS.CALLEE.password=your-password

.eslintrc.cjs

@@ -9,10 +9,12 @@ module.exports = {
     ],
     ignorePatterns: [
         'src/helpers/webrtcmetrics/',
-        'docs'
+        'docs',
+        'tests/ui'
     ],
     rules: {
-        'space-before-blocks': 'off'
+        'space-before-blocks': 'off',
+        'no-dupe-class-members': 'off'
     },
     env: {
         es2021: true,

.gitignore

@@ -188,3 +188,9 @@ fabric.properties
 # .pnp.*
 
 # End of https://www.toptal.com/developers/gitignore/api/webstorm,node,yarn
+
+# Playwright
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/

.gitlab-ci.yml

@@ -0,0 +1,63 @@
+stages:
+  - test_stage
+  - build_stage
+  - deploy_stage
+
+variables:
+  IMAGE_NAME: "registry.voicenter.co/voicenter/mirrored-opensips-js"
+  GITHUB_IMAGE_NAME: "ghcr.io/voicenterteam/opensipsjs-test"
+
+test:
+  stage: test_stage
+  image: mcr.microsoft.com/playwright:v1.52.0-jammy
+  script:
+    - yarn install --frozen-lockfile
+    - npx playwright install
+    - chmod +x start.sh
+    - ./start.sh
+  only:
+    - branches
+  artifacts:
+    paths:
+      - node_modules/ 
+      - dist/
+    expire_in: 1 hour
+  tags:
+      - gitRunCT
+
+
+build:
+  stage: build_stage
+  image: docker:latest
+  services:
+    - docker:dind
+  script:
+    - docker login registry.voicenter.co -u $dplUser -p $dplPswd
+    - docker build -t $IMAGE_NAME:$CI_COMMIT_BRANCH .
+    - docker tag $IMAGE_NAME:$CI_COMMIT_BRANCH $IMAGE_NAME:latest
+    - docker push $IMAGE_NAME:${CI_COMMIT_BRANCH}
+    - docker push $IMAGE_NAME:latest
+  dependencies:
+    - test
+  only:
+    - branches
+  tags:
+      - gitRunCT
+
+deploy:
+  stage: deploy_stage
+  image: docker:latest
+  services:
+    - docker:dind
+  script:
+    - docker login registry.voicenter.co -u $dplUser -p $dplPswd
+    - docker pull $IMAGE_NAME:$CI_COMMIT_BRANCH
+    - echo "$GHCR_TOKEN" | docker login ghcr.io -u $GHCR_USER --password-stdin
+    - docker tag $IMAGE_NAME:$CI_COMMIT_BRANCH $GITHUB_IMAGE_NAME:$CI_COMMIT_BRANCH
+    - docker push $GITHUB_IMAGE_NAME:$CI_COMMIT_BRANCH
+  only:
+    - branches
+  dependencies:
+    - build
+  tags:
+      - gitRunCT

DEBUG_SETUP.md

@@ -0,0 +1,140 @@
+# Debug Server Setup for OpenSIPS-JS Testing Framework
+
+This setup provides a local debug server to collect and visualize logs, metrics, and traces from your OpenSIPS-JS testing framework.
+
+## Quick Start
+
+### 1. Start the Debug Server
+
+```bash
+yarn debug-server
+```
+
+This starts the debug server at `http://localhost:3001`
+
+### 2. Access the Dashboard
+
+Open your browser and go to:
+```
+http://localhost:3001
+```
+
+You'll see a real-time dashboard showing:
+- 📝 **Logs**: All QrynLogger output with structured metadata
+- 📊 **Metrics**: Test event metrics and custom metrics
+- 🔗 **Traces**: OpenTelemetry traces with spans
+- 🎵 **WebRTC**: Real-time audio quality metrics
+
+### 3. Run Tests with Debug Mode
+
+```bash
+yarn run-test-debug
+```
+
+This automatically:
+1. Copies the debug configuration (`.env.debug` → `.env`)
+2. Runs your tests with all telemetry pointing to the local debug server
+
+## What You'll See
+
+### Dashboard Features
+
+- **Real-time Updates**: Auto-refreshes every 5 seconds
+- **Scenario Correlation**: All data tagged with scenario names for easy filtering
+- **Structured Data**: Logs include metadata, metrics include labels
+- **Clear Functionality**: Reset collected data anytime
+- **Color Coding**: Errors highlighted in red, different data types color-coded
+
+### Logs Section
+```
+2024-01-15T10:30:15.123Z [My Test Scenario] [ActionsExecutor] - Executing register action
+{
+  "data": {
+    "username": "caller",
+    "sip_domain": "example.com"
+  }
+}
+```
+
+### Metrics Section  
+```
+opensips_test_events_total: 1
+Labels: {
+  "scenario_name": "My Test Scenario",
+  "event_name": "register", 
+  "stage": "triggered",
+  "status": "success"
+}
+```
+
+### WebRTC Section
+```
+opensips_webrtc_jitter_ms: 12.5
+Labels: {
+  "scenario_name": "My Test Scenario",
+  "metric_type": "webrtc_audio"
+}
+```
+
+## Debug Server Endpoints
+
+The server exposes the same endpoints that qryn would use:
+
+- **Logs**: `POST /loki/api/v1/push` (Loki format)
+- **Traces**: `POST /v1/traces` (OpenTelemetry format)  
+- **Metrics**: `POST /v1/metrics` (OpenTelemetry format)
+- **Prometheus**: `POST /api/v1/prom/remote/write` (Prometheus format)
+- **Legacy**: `POST /collect-metrics` (Fallback format)
+
+## Configuration
+
+The debug configuration (`.env.debug`) sets:
+
+```bash
+# Local debug server configuration
+GIGAPIPE.DEFAULT.url=http://localhost:3001
+GIGAPIPE.DEFAULT.scope=debug
+GIGAPIPE.DEFAULT.headers.Content-Type=application/json
+```
+
+This makes all services (logs, traces, metrics) use the local debug server.
+
+## Troubleshooting
+
+### No Data Appearing?
+
+1. **Check Server**: Ensure debug server is running on port 3001
+2. **Check Configuration**: Verify `.env` points to `http://localhost:3001`
+3. **Check Console**: Look for connection errors in the debug server console
+4. **Check Browser**: Open browser dev tools to see any frontend errors
+
+### Port Conflicts?
+
+If port 3001 is busy, edit `debug-server.js`:
+```javascript
+const PORT = 3002  // Change to available port
+```
+
+And update `.env.debug`:
+```bash
+GIGAPIPE.DEFAULT.url=http://localhost:3002
+```
+
+### Clear Old Data
+
+Click "Clear All" in the dashboard or restart the debug server.
+
+## Production vs Debug
+
+- **Debug Mode**: Uses local server for easy visualization
+- **Production Mode**: Configure real qryn endpoints in `.env`
+
+The same code works for both - just change the endpoint URLs!
+
+## Benefits
+
+- ✅ **Verify Integration**: See that all telemetry is working
+- ✅ **Debug Issues**: Trace problems across logs/metrics/traces  
+- ✅ **Performance Monitoring**: Watch WebRTC quality in real-time
+- ✅ **Scenario Correlation**: Filter by scenario name
+- ✅ **No External Dependencies**: Works offline locally

Dockerfile

@@ -0,0 +1,17 @@
+FROM mcr.microsoft.com/playwright:v1.52.0-jammy
+
+WORKDIR /app
+
+COPY package.json yarn.lock ./
+RUN apt-get update && yarn install --ignore-engines
+RUN npx playwright install
+
+
+COPY . .
+
+EXPOSE 5173
+
+COPY start.sh ./
+RUN chmod +x start.sh
+
+CMD ["./start.sh"]