Merge branch 'pro_setup'

.dockerignore

@@ -1,38 +1,36 @@
 # ====================================================
 # NODE.JS & NPM
 # ====================================================
-**/node_modules/
+**/**/node_modules/
-**/npm-debug.log*
+**/**/npm-debug.log*
-**/yarn-debug.log*
+**/**/yarn-debug.log*
-**/yarn-error.log*
+**/**/yarn-error.log*
-**/lerna-debug.log*
+**/**/lerna-debug.log*
-**/.npm
+**/**/.npm
-**/.pnpm-debug.log*
+**/**/.pnpm-debug.log*
 
 # ====================================================
 # BUILD OUTPUTS & DIST
 # ====================================================
-**/dist/
+**/**/dist/
-**/build/
+**/**/build/
-**/coverage/
+**/**/coverage/
-**/.nyc_output/
+**/**/.nyc_output/
-**/lib-cov/
+**/**/lib-cov/
 
 # # ====================================================
 # # ANGULAR SPECIFIC
 # # ====================================================
-**/.angular/
+**/**/.angular/
 
 
 # ====================================================
 # TESTING & E2E
 # ====================================================
-**/e2e/
+**/**/e2e/
-**/tests/screenshots/
+**/**/tests/
-**/tests/videos/
+**/**/test-results/
-**/tests/results/
+**/**/playwright-report/
-**/test-results/
-**/playwright-report/
 **/test_localstorage_state.json
 **/*_current.png
 **/*_mask.png
@@ -40,8 +38,11 @@
 **/*.test.js.map
 **/cypress/
 **/jest-coverage/
-**/.jest/
+**/**/.jest/
-**/testapp/
+**/**/jest.*
+**/**/testapp/
+**/**/__mocks__/
+**/**/karma.*
 
 # ====================================================
 # DEVELOPMENT TOOLS & EDITORS
@@ -81,22 +82,23 @@
 # ====================================================
 # ENVIRONMENT & CONFIG
 # ====================================================
-**/.env
+**/**/.env
-**/.env.local
+**/**/.env.local
-**/.env.development.local
+**/**/.env.development.local
-**/.env.test.local
+**/**/.env.test.local
-**/.env.production.local
+**/**/.env.production.local
-**/.env.*.local
+**/**/.env.*.local
+**/**/nodemon.**
 
 # ====================================================
 # DOCUMENTATION & README
 # ====================================================
-**/README.md
+**/**/README.md
-**/CHANGELOG.md
+**/**/CHANGELOG.md
-**/docs/
+**/**/docs/
-**/documentation/
+**/**/documentation/
-**/*.md
+**/**/*.md
-**/webhooks-snippets/
+**/**/webhooks-snippets/
 
 # ====================================================
 # LINTING & FORMATTING
@@ -125,11 +127,11 @@
 # ====================================================
 # CERTIFICATES & KEYS
 # ====================================================
-**/*.pem
+**/**/*.pem
-**/*.key
+**/**/*.key
-**/*.cert
+**/**/*.cert
-**/*.p12
+**/**/*.p12
-**/*.crt
+**/**/*.crt
 
 # ====================================================
 # MEDIA & ASSETS (Large files)
@@ -146,32 +148,18 @@
 # ====================================================
 # WORKSPACE & PROJECT FILES
 # ====================================================
-**/*.code-workspace
+**/**/*.code-workspace
-**/.project
-**/.classpath
-**/.settings/
-
-# ====================================================
-# CACHE FILES
-# ====================================================
-**/.cache/
-**/cache/
-**/.parcel-cache/
-**/.next/
-**/.nuxt/
-**/.gatsby/
 
 # ====================================================
 # BACKEND SPECIFIC
 # ====================================================
-**/uploads/
+**/**/public/
-**/sessions/
-**/public/
 
 # ====================================================
 # FRONTEND BUILD ARTIFACTS
 # ====================================================
-**/webcomponent/dist/
+**/**/node_modules/
-**/webcomponent/node_modules/
+**/**/*.tgz
-**/frontend/dist/
+**/**/webcomponent/dist/
-**/frontend/.angular/
+**/**/frontend/dist/
+**/**/frontend/.angular/

.github/workflows/backend-unit-test.yaml

@@ -10,20 +10,27 @@ jobs:
     runs-on: ov-actions-runner
     steps:
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: '22.13'
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - name: Checkout OpenVidu Meet
         uses: actions/checkout@v4
-      - name: Setup OpenVidu Meet Backend
+
-        shell: bash
+      - name: Install dependencies
-        run: ./prepare.sh --typings --backend
+        run: ./meet.sh install
+
+      - name: Build typings
+        run: ./meet.sh build-typings --skip-install
+
       - name: Run tests
-        run: |
+        run: ./meet.sh test-unit-backend --skip-install
-          cd backend
-          npm run test:unit
         env:
-          JEST_JUNIT_OUTPUT_DIR: './reports/'
+          JEST_JUNIT_OUTPUT_DIR: './backend/reports/'
+
       - name: Publish Test Report
         uses: mikepenz/action-junit-report@v4
         if: always()
@@ -31,6 +38,7 @@ jobs:
           report_paths: '**/reports/junit.xml'
           fail_on_failure: true
           require_tests: true
+
       - name: Clean up
         if: always()
         uses: OpenVidu/actions/cleanup@main

.github/workflows/wc-e2e-test.yaml

@@ -10,9 +10,13 @@ jobs:
     runs-on: ov-actions-runner
     steps:
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: '22.13'
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - name: Setup OpenVidu Local Deployment
         uses: OpenVidu/actions/start-openvidu-local-deployment@main
         with:
@@ -26,25 +30,27 @@ jobs:
             fi
             BASH
             chmod +x pre_startup_commands.sh && ./pre_startup_commands.sh
-      - name: Setup OpenVidu Meet
+
+      - name: Build and Start OpenVidu Meet
         uses: OpenVidu/actions/start-openvidu-meet@main
         env:
           MEET_INITIAL_WEBHOOK_ENABLED: true
           MEET_INITIAL_WEBHOOK_URL: 'http://localhost:5080/webhook'
+
       - name: Start OpenVidu Meet Testapp
         uses: OpenVidu/actions/start-openvidu-meet-testapp@main
         with:
+          skip_install: 'true'
           skip_checkout: 'true'
+          skip_build_typings: 'true'
+          skip_build_webcomponent: 'true'
+
       - name: Run tests
-        run: |
+        run: ./meet.sh test-e2e-webcomponent --skip-install
-          cd frontend/webcomponent
-          # Install Playwright browsers
-          mkdir -p /tmp/ms-playwright
-          npx playwright install --with-deps chromium
-          npm run test:e2e
         env:
           RUN_MODE: CI
           PLAYWRIGHT_BROWSERS_PATH: /tmp/ms-playwright
+
       - name: Upload test results
         if: always()
         uses: actions/upload-artifact@v4
@@ -52,6 +58,7 @@ jobs:
           name: room-test-results
           path: frontend/webcomponent/test-results/
           retention-days: 2
+
       - name: Upload TestApp logs on failure
         if: failure()
         uses: actions/upload-artifact@v4
@@ -59,6 +66,7 @@ jobs:
           name: room-test-testapp-logs
           path: testapp/testapp.log
           retention-days: 2
+
       - name: Upload OpenVidu Meet logs on failure
         if: failure()
         uses: actions/upload-artifact@v4
@@ -66,6 +74,7 @@ jobs:
           name: room-test-openvidu-meet-logs
           path: backend/meet_backend.log
           retention-days: 2
+
       - name: Clean up
         if: always()
         uses: OpenVidu/actions/cleanup@main

.github/workflows/wc-unit-test.yaml

@@ -10,18 +10,28 @@ jobs:
     runs-on: ov-actions-runner
     steps:
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: '22.13'
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - name: Checkout OpenVidu Meet
         uses: actions/checkout@v4
-      - name: Setup OpenVidu Meet WebComponent
+
-        shell: bash
+      - name: Install dependencies
-        run: ./prepare.sh --typings --webcomponent
+        run: ./meet.sh install
+
+      - name: Build typings
+        run: ./meet.sh build-typings --skip-install
+
+      - name: Build webcomponent
+        run: ./meet.sh build-webcomponent --skip-install --skip-typings
+
       - name: Run tests
-        run: |
+        run: ./meet.sh test-unit-webcomponent --skip-install
-          cd frontend/webcomponent
+
-          npm run test:unit
       - name: Clean up
         if: always()
         uses: OpenVidu/actions/cleanup@main

.gitignore

@@ -1,20 +1,22 @@
 # See http://help.github.com/ignore-files/ for more about ignoring files.
 
 # compiled output
-*.angular
+**/**/*.angular
-**/dist
+**/**/dist
 /tmp
 /out-tsc
-*.tgz
+**/**/*.tgz
 
 
 # dependencies
-**/*/node_modules
+**/**/node_modules
-**/*/target
+**/**/target
+
+# pnpm
+.pnpm-store
+.pnpm-debug.log
+pnpm-debug.log*
 
-# profiling files
-chrome-profiler-events*.json
-speed-measure-plugin*.json
 
 # IDEs and editors
 /.idea
@@ -28,37 +30,19 @@ speed-measure-plugin*.json
 # IDE - VSCode
 .history/*
 
-# misc
-/.sass-cache
-/connect.lock
-/coverage
-/libpeerconnection.log
-npm-debug.log
-yarn-error.log
-testem.log
-./**/typings
-
-# System Files
-.DS_Store
-Thumbs.db
 
 .editorconfig
 *.browserslistrc
 .git/*
 
 
-backend/public/
+**/**/test-results
+**/**/public/
 
-frontend/projects/shared-meet-components/src/lib/typings/
-
-backend/src/typings/
 **/*/coverage
+**/**/test-results
+**/**/openvidu-meet.**.js
 
-frontend/webcomponent/**/openvidu-meet.**.js
+**/**/docs/webcomponent-attributes.md
-testapp/public/js/app.js
+**/**/docs/webcomponent-commands.md
-testapp/public/js/webcomponent.js
+**/**/docs/webcomponent-events.md
-frontend/webcomponent/test-results/.last-run.json
-frontend/webcomponent/test_localstorage_state.json
-
-**test-results/**
-frontend/webcomponent/src/typings/

.npmrc

@@ -0,0 +1,17 @@
+# Strict peer dependencies
+strict-peer-dependencies=false
+
+# Auto install peers
+auto-install-peers=true
+
+# Shamefully hoist - neccessary for some packages
+shamefully-hoist=true
+
+# Node linker - use hoisted for full compatibility
+node-linker=hoisted
+
+# Lockfile settings
+lockfile=true
+
+# Optional: Store location (uncomment if you want to customize)
+# store-dir=.pnpm-store

README.md

@@ -1,128 +1,233 @@
 # OpenVidu Meet
 
+OpenVidu Meet is a fully featured video conferencing application built with Angular, Node.js, and LiveKit. This repository provides both a Community Edition (CE) and a Professional Edition (PRO) with advanced features.
+
 # Table of Contents
 
 1. [Architecture Overview](#architecture-overview)
-2. [Development](#development)
+2. [Prerequisites](#prerequisites)
-   - [1. Clone the Repository](#1-clone-the-openvidu-meet-repository)
+3. [Getting Started](#getting-started)
-   - [2. Prepare the Project](#2-prepare-the-project)
+4. [Development](#development)
-   - [3. Start the Backend](#3-start-the-backend)
+   - [Development Mode](#development-mode)
-   - [4. Start the Frontend](#4-start-the-frontend)
+   - [Manual Development Setup](#manual-development-setup)
-3. [Testing](#testing)
+5. [Building](#building)
-4. [Build (with Docker)](#build-with-docker)
+6. [Testing](#testing)
-   - [Build the Backend Image](#build-the-backend-image)
+7. [Documentation](#documentation)
-   - [Run the Backend Container](#run-the-backend-container)
+8. [Production Deployment](#production-deployment)
+9. [Project Structure](#project-structure)
+10. [Using the meet.sh Script](#using-the-meetsh-script)
 
 ## Architecture Overview
 
-The OpenVidu Meet application is composed of two main parts (frontend and backend) that interact with each other to provide the video conferencing service. The following diagram illustrates the architecture of the application:
+The OpenVidu Meet application is a monorepo managed with **pnpm workspaces** and consists of multiple interconnected packages:
 
 [![OpenVidu Meet CE Architecture Overview](docs/openvidu-meet-ce-architecture.png)](/docs/openvidu-meet-ce-architecture.png)
 
-- **Frontend**: The frontend is a web application built with Angular that provides the user interface for the video conferencing service. This project contains the **shared-meet-components** subproject, which is a library of shared components that share administration and preference components.
+### Core Components
 
-  Also, the frontend project installs external dependencies on the following libraries:
+- **Frontend** (`frontend/`): Angular 20 application providing the user interface
+  - **shared-meet-components**: Reusable Angular library with shared components for administration and preferences
+  - Integrates [openvidu-components-angular](https://github.com/OpenVidu/openvidu/tree/master/openvidu-components-angular) for core video conferencing functionality
 
-  - [**openvidu-components-angular**](https://github.com/OpenVidu/openvidu/tree/master/openvidu-components-angular): A library of Angular components that provide the core functionality of the video conferencing service.
+- **Backend** (`backend/`): Node.js/TypeScript REST API server
-  - [**typings**](./typings/): Common types used by the frontend and backend.
+  - Manages rooms, participants, recordings, and authentication
+  - Serves the compiled frontend in production
 
-- **Backend**: The backend is a Node.js application.
+- **Typings** (`typings/`): Shared TypeScript type definitions used across frontend and backend
-  - [**typings**](./typings/): Common types used by the frontend and backend.
+
+- **Webcomponent** (`frontend/webcomponent/`): Standalone web component version of OpenVidu Meet
+
+- **TestApp** (`testapp/`): Testing application for development and validation
+
+## Prerequisites
+
+Before starting, ensure you have the following installed:
+
+- **Node.js**: Version 22 or higher
+- **pnpm**: Package manager (will be installed automatically by meet.sh if missing)
+- **LiveKit**: For local testing (optional)
+  ```bash
+  curl -sSL https://get.livekit.io/cli | bash
+  ```
+
+## Getting Started
+
+The simplest way to get started is using the `meet.sh` script:
+
+```bash
+# Clone the repository
+git clone https://github.com/OpenVidu/openvidu-meet.git
+cd openvidu-meet
+
+# Install all dependencies
+./meet.sh install
+
+# Start development mode with hot-reload
+./meet.sh dev
+```
+
+Access the application at [http://localhost:6080](http://localhost:6080)
 
 ## Development
 
-For development purposes, you can run the application locally by following the instructions below.
+### Development Mode
 
-**1. Clone the OpenVidu Meet repository:**
+The recommended way to develop is using the integrated development mode that watches all components:
 
 ```bash
-git clone https://github.com/OpenVidu/openvidu-meet.git
+./meet.sh dev
 ```
 
-**2. Prepare the project**
+This command starts concurrent watchers for:
-
+- **openvidu-components-angular**: Core Angular components library
-For building types and install dependencies, run the following command:
+- **Typings**: Shared type definitions with automatic sync
-
+- **Backend**: Node.js server with nodemon auto-restart
-```bash
+- **Frontend**: Angular application with live reload
-cd openvidu-meet
+- **REST API Docs**: OpenAPI documentation generation
-./prepare.sh
-```
-
-**3. Start the Backend**
 
 > [!NOTE]
-> For development purposes, the backend application uses the `backend/.env.development` file to load environment variables. You can customize the values in this file to suit your local development environment.
+> The backend uses `backend/.env.development` for environment variables during development. Configure your LiveKit credentials there:
+> ```env
+> LIVEKIT_URL=ws://localhost:7880
+> LIVEKIT_API_KEY=your-api-key
+> LIVEKIT_API_SECRET=your-api-secret
+> ```
+
+### Manual Development Setup
+
+If you prefer more granular control:
 
 ```bash
-cd backend && \
+# Install dependencies
-npm run start:dev
+./meet.sh install
+
+# Build shared typings (required first)
+./meet.sh build-typings
+
+# In separate terminals:
+# Terminal 1 - Backend
+cd backend
+pnpm run start:dev
+
+# Terminal 2 - Frontend
+cd frontend
+pnpm run dev
+
+# Terminal 3 - Typings watcher (optional)
+cd typings
+pnpm run dev
 ```
 
-> [!NOTE]
+> [!IMPORTANT]
-> **The types under `typings` are shared between the frontend and backend projects.**
+> **Shared Typings**: The `typings/` package contains types shared between frontend and backend. When you modify these types in development mode, they are automatically synced to both projects. Always build typings before building other components.
-> If you need to update the comon types, remember doing it in the `typings` project.
->
-> Every time you make changes to the types, the backend process will automatically invoke the syncing task to update the types in the frontend and backend projects. So, you don't need to worry about updating the types manually.
 
-**4. Start the Frontend**
+## Building
 
-Opening a new tab, under root directory:
+Build all components in the correct order:
 
 ```bash
-cd frontend && \
+# Build everything (typings → frontend → backend → webcomponent)
-npm run build:dev
+./meet.sh build
+
+# Or build individual components:
+./meet.sh build-typings          # Build shared types
+./meet.sh build-webcomponent     # Build web component only
+./meet.sh build-testapp          # Build test application
 ```
 
-This command will build the frontend application and move the files to the backend project. It will also listen for changes in the frontend application and rebuild the application when changes are detected.
+### CI/CD Optimized Builds
 
-After running these commands, you can access the frontend application at [http://localhost:6080](http://localhost:6080).
+The `meet.sh` script supports flags to optimize CI/CD pipelines:
+
+```bash
+# Install dependencies once
+./meet.sh install
+
+# Build typings once
+./meet.sh build-typings
+
+# Build webcomponent (skip already completed steps)
+./meet.sh build-webcomponent --skip-install --skip-typings
+
+# Run tests without reinstalling
+./meet.sh test-unit-webcomponent --skip-install
+```
+
+**Available flags:**
+- `--skip-install`: Skip dependency installation
+- `--skip-build`: Skip build steps
+- `--skip-typings`: Skip typings build (use when already built)
 
 ## Testing
 
-This repository offers a testing application that allows you to test the OpenVidu Meet.
+OpenVidu Meet includes comprehensive testing capabilities:
 
-### Pre-requisites
+### Unit Tests
-
-To run the testing application, you need to have the following pre-requisites installed:
-
-- [Node.js](https://nodejs.org/en/download/) (version 22 or higher)
-- LiveKit CLI installed and configured.
 
 ```bash
-curl -sSL https://get.livekit.io/cli | bash
+# Backend unit tests
+./meet.sh test-unit-backend
+
+# Webcomponent unit tests
+./meet.sh test-unit-webcomponent
 ```
 
-To run the testing application, follow these steps under the root directory:
+### End-to-End Tests
-
-1. Install the dependencies:
 
 ```bash
-cd testapp && \
+# Run E2E tests for webcomponent (installs Playwright automatically)
-npm install
+./meet.sh test-e2e-webcomponent
+
+# Force reinstall Playwright browsers
+./meet.sh test-e2e-webcomponent --force-install
 ```
 
-2. Start the testing application:
+### TestApp
+
+The repository includes a dedicated testing application for manual testing:
 
 ```bash
-npm run start
+# Build and start the test application
+./meet.sh start-testapp
 ```
 
-After running these commands, you can access the testing application at [http://localhost:5080](http://localhost:5080).
+The test app will be available at [http://localhost:5080](http://localhost:5080)
 
-## Build (with docker)
+> [!NOTE]
+> The TestApp requires LiveKit CLI to be installed and configured for full functionality.
 
-### Build the backend image
+## Documentation
+
+### Generate Documentation
 
 ```bash
-cd docker
+# Generate webcomponent documentation
-./create_image.sh openvidu-meet-ce
+./meet.sh build-webcomponent-doc [output_dir]
+
+# Generate REST API documentation
+./meet.sh build-rest-api-doc [output_dir]
 ```
 
-### Run the backend container
+Documentation files will be generated in:
+- **Webcomponent**: `docs/webcomponent-*.md` (events, commands, attributes)
+- **REST API**: `backend/public/openapi/public.html`
 
-Once the image is created, you can run the container with the following command:
+If you specify an output directory, the documentation will be copied there.
+
+## Production Deployment
+
+### Using Docker
+
+Build and run the production container:
 
 ```bash
+# Build the Docker image (using meet.sh)
+./meet.sh build-docker openvidu-meet-ce
+
+# Build Docker image for demos (different BASE_HREF)
+./meet.sh build-docker openvidu-meet-ce --demos
+
+# Run the container
 docker run \
   -e LIVEKIT_URL=<your-livekit-url> \
   -e LIVEKIT_API_KEY=<your-livekit-api-key> \
@@ -131,4 +236,166 @@ docker run \
   openvidu-meet-ce
 ```
 
-You can check all the available environment variables in the [environment file](backend/src/environment.ts).
+### Manual Production Start
+
+```bash
+# Build all components
+./meet.sh build
+
+# Start in production mode
+./meet.sh start --prod
+
+# Or start in CI mode
+./meet.sh start --ci
+```
+
+### Environment Variables
+
+Configure your production environment using these key variables:
+
+- `LIVEKIT_URL`: WebSocket URL for LiveKit server
+- `LIVEKIT_API_KEY`: LiveKit API key
+- `LIVEKIT_API_SECRET`: LiveKit API secret
+- `SERVER_PORT`: Backend server port (default: 6080)
+- `NODE_ENV`: Environment mode (`development`, `production`, `ci`)
+
+For a complete list of environment variables, see [backend/src/environment.ts](backend/src/environment.ts).
+
+## Project Structure
+
+```
+openvidu-meet/
+├── meet.sh                          # Main build and development script
+├── pnpm-workspace.yaml              # pnpm workspace configuration
+├── package.json                     # Root package with scripts
+│
+├── typings/                         # Shared TypeScript definitions
+│   ├── src/
+│   │   ├── api-key.ts
+│   │   ├── auth-config.ts
+│   │   ├── participant.ts
+│   │   ├── event.model.ts
+│   │   └── ...
+│   └── package.json
+│
+├── frontend/                        # Angular frontend application
+│   ├── src/                        # Main application source
+│   ├── projects/
+│   │   └── shared-meet-components/ # Reusable Angular library
+│   └── webcomponent/               # Web component build
+│
+├── backend/                         # Node.js/Express backend
+│   ├── src/
+│   │   ├── controllers/            # REST API controllers
+│   │   ├── services/               # Business logic
+│   │   ├── middleware/             # Express middleware
+│   │   └── environment.ts          # Environment configuration
+│   ├── openapi/                    # OpenAPI specifications
+│   └── public/                     # Static files (includes built frontend)
+│
+├── testapp/                         # Testing application
+│   ├── src/
+│   └── public/
+│
+├── docker/                          # Docker build files
+│   └── create_image.sh
+│
+├── docs/                            # Generated documentation
+├── scripts/                         # Build and utility scripts
+└── openvidu-meet-pro/              # Professional Edition (separate license)
+```
+
+## Using the meet.sh Script
+
+The `meet.sh` script is the main entry point for all development and build tasks:
+
+### Command Reference
+
+```bash
+# Help
+./meet.sh help
+
+# Installation
+./meet.sh install                    # Install all dependencies
+
+# Building
+./meet.sh build                      # Build all components
+./meet.sh build-typings              # Build shared types only
+./meet.sh build-webcomponent         # Build webcomponent only
+./meet.sh build-testapp              # Build test application
+
+# Development
+./meet.sh dev                        # Start development mode with watchers
+
+# Testing
+./meet.sh test-unit-backend          # Run backend unit tests
+./meet.sh test-unit-webcomponent     # Run webcomponent unit tests
+./meet.sh test-e2e-webcomponent      # Run webcomponent E2E tests
+
+# Running
+./meet.sh start --prod               # Start in production mode
+./meet.sh start --ci                 # Start in CI mode
+./meet.sh start-testapp              # Start test application
+
+# Documentation
+./meet.sh build-webcomponent-doc [dir]  # Generate webcomponent docs
+./meet.sh build-rest-api-doc [dir]      # Generate REST API docs
+
+# Docker
+./meet.sh build-docker <image-name> [--demos]  # Build Docker image
+```
+
+### Examples
+
+```bash
+# Full development workflow
+./meet.sh install
+./meet.sh dev
+
+# CI/CD optimized workflow
+./meet.sh install
+./meet.sh build-typings
+./meet.sh build-webcomponent --skip-install --skip-typings
+./meet.sh test-unit-webcomponent --skip-install
+
+# Production build and deploy
+./meet.sh build
+./meet.sh start --prod
+
+# Build Docker image
+./meet.sh build-docker openvidu-meet-ce
+
+# Build Docker image for demos
+./meet.sh build-docker openvidu-meet-ce --demos
+```
+
+## Technologies
+
+- **Frontend**: Angular 20, Material Design, TypeScript
+- **Backend**: Node.js, Express, TypeScript
+- **WebRTC Infrastructure**: LiveKit
+- **Package Manager**: pnpm (workspaces)
+- **Build Tools**: Angular CLI, TypeScript Compiler, Rollup (webcomponent)
+- **Testing**: Jest (unit), Playwright (E2E), Mocha
+- **Documentation**: OpenAPI/Swagger, Custom generators
+
+## Contributing
+
+Contributions are welcome! Please ensure that:
+
+1. All tests pass: `./meet.sh test-unit-backend && ./meet.sh test-unit-webcomponent`
+2. Code is properly formatted
+3. TypeScript types are correctly defined in `typings/`
+4. Documentation is updated as needed
+
+## License
+
+Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.
+
+## Links
+
+- [OpenVidu Website](https://openvidu.io/)
+- [OpenVidu Meet](https://openvidu.io/latest/meet/)
+---
+
+For questions and support, visit our [community forum](https://openvidu.discourse.group/).

backend/nodemon.json

@@ -1,12 +0,0 @@
-{
-	"env": {
-		"NODE_ENV": "development"
-	},
-	"watch": ["openapi/**/*.yaml", "src", "../typings/src"],
-	"ext": "js,json,ts,yaml,yml",
-	"ignore": ["node_modules", "dist", "src/typings", "public"],
-	"exec": "node --import tsx ./src/server.ts",
-	"events": {
-		"restart": "npm run typings:sync && npm run doc:api && npm run doc:internal-api"
-	}
-}

backend/package.json

@@ -1,115 +0,0 @@
-{
-	"name": "openvidu-meet-backend",
-	"version": "3.4.1",
-	"description": "OpenVidu Meet Backend",
-	"author": "OpenVidu",
-	"license": "Apache-2.0",
-	"homepage": "https://github.com/OpenVidu/openvidu-meet#readme",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/OpenVidu/openvidu-meet.git"
-	},
-	"bugs": {
-		"url": "https://github.com/OpenVidu/openvidu-meet/issues"
-	},
-	"keywords": [
-		"openvidu",
-		"webrtc",
-		"openvidu-meet"
-	],
-	"main": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"type": "module",
-	"files": [
-		"dist",
-		"src",
-		"openapi",
-		"package.json"
-	],
-	"scripts": {
-		"build:prod": "tsc",
-		"postbuild:prod": "npm run doc:api && npm run doc:internal-api",
-		"doc:api": "mkdir -p public/openapi && cd openapi && npx openapi-generate-html -i openvidu-meet-api.yaml --ui=stoplight --theme=light --title 'OpenVidu Meet REST API' --description 'OpenVidu Meet REST API' -o ../public/openapi/public.html",
-		"doc:internal-api": "mkdir -p public/openapi && cd openapi && npx openapi-generate-html -i openvidu-meet-internal-api.yaml --ui=stoplight --theme=dark --title 'OpenVidu Meet Internal REST API' --description 'OpenVidu Meet Internal REST API' -o ../public/openapi/internal.html",
-		"start:prod": "NODE_ENV=production node dist/src/server.js",
-		"start:dev": "NODE_ENV=development nodemon",
-		"start:ci": "NODE_ENV=ci node dist/src/server.js",
-		"package:build": "npm run build:prod && npm pack",
-		"lib:sync-pro": "npm run package:build && cp openvidu-meet-server-*.tgz ../../openvidu-meet-pro/backend",
-		"typings:sync": "npm run sync-ce --prefix ../typings",
-		"test:integration": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/integration\" --ci --reporters=default --reporters=jest-junit",
-		"test:integration-rooms": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/integration/api/rooms\" --ci --reporters=default --reporters=jest-junit",
-		"test:integration-recordings": "node --experimental-vm-modules node_modules/.bin/jest --maxWorkers=1 --maxConcurrency=1 --forceExit --testPathPattern \"tests/integration/api/recordings\" --ci --reporters=default --reporters=jest-junit",
-		"test:integration-webhooks": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/integration/webhooks\" --ci --reporters=default --reporters=jest-junit",
-		"test:integration-security": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/integration/api/security\" --ci --reporters=default --reporters=jest-junit",
-		"test:integration-global-config": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/integration/api/global-config\" --ci --reporters=default --reporters=jest-junit",
-		"test:integration-participants": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/integration/api/participants\" --ci --reporters=default --reporters=jest-junit",
-		"test:integration-meetings": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/integration/api/meetings\" --ci --reporters=default --reporters=jest-junit",
-		"test:integration-users": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/integration/api/users\" --ci --reporters=default --reporters=jest-junit",
-		"test:unit": "node --experimental-vm-modules node_modules/.bin/jest --runInBand --forceExit --testPathPattern \"tests/unit\" --ci --reporters=default --reporters=jest-junit",
-		"lint:fix": "eslint src --fix",
-		"format:code": "prettier --ignore-path .gitignore --write '**/*.{ts,js,json,md}'"
-	},
-	"dependencies": {
-		"@aws-sdk/client-s3": "3.846.0",
-		"@azure/storage-blob": "12.27.0",
-		"@google-cloud/storage": "7.17.1",
-		"@sesamecare-oss/redlock": "1.4.0",
-		"archiver": "7.0.1",
-		"bcrypt": "5.1.1",
-		"body-parser": "2.2.0",
-		"chalk": "5.6.2",
-		"cookie-parser": "1.4.7",
-		"cors": "2.8.5",
-		"cron": "4.3.3",
-		"dotenv": "16.6.1",
-		"express": "4.21.2",
-		"express-openapi-validator": "5.5.7",
-		"express-rate-limit": "7.5.1",
-		"inversify": "6.2.2",
-		"ioredis": "5.6.1",
-		"jwt-decode": "4.0.0",
-		"livekit-server-sdk": "2.13.1",
-		"ms": "2.1.3",
-		"uid": "2.0.2",
-		"winston": "3.18.3",
-		"yamljs": "0.3.0",
-		"zod": "3.25.76"
-	},
-	"devDependencies": {
-		"@types/archiver": "6.0.3",
-		"@types/bcrypt": "5.0.2",
-		"@types/cookie-parser": "1.4.9",
-		"@types/cors": "2.8.19",
-		"@types/express": "4.17.23",
-		"@types/jest": "29.5.14",
-		"@types/ms": "2.1.0",
-		"@types/node": "22.16.4",
-		"@types/supertest": "6.0.3",
-		"@types/swagger-ui-express": "4.1.8",
-		"@types/unzipper": "0.10.11",
-		"@types/validator": "13.15.2",
-		"@types/yamljs": "0.2.34",
-		"@typescript-eslint/eslint-plugin": "6.21.0",
-		"@typescript-eslint/parser": "6.21.0",
-		"cross-env": "7.0.3",
-		"eslint": "8.57.1",
-		"eslint-config-prettier": "9.1.0",
-		"jest": "29.7.0",
-		"jest-fetch-mock": "3.0.3",
-		"jest-junit": "16.0.0",
-		"nodemon": "3.1.10",
-		"openapi-generate-html": "0.4.4",
-		"prettier": "3.6.2",
-		"supertest": "7.1.3",
-		"ts-jest": "29.4.0",
-		"ts-jest-resolver": "2.0.1",
-		"tsx": "4.20.3",
-		"typescript": "5.8.3",
-		"unzipper": "0.12.3"
-	},
-	"jest-junit": {
-		"outputDirectory": "test-results",
-		"outputName": "junit.xml"
-	}
-}

docker/Dockerfile

@@ -1,50 +0,0 @@
-# ====================================================
-# Stage 1: builder
-# ====================================================
-FROM node:22.19.0 AS builder
-
-WORKDIR /app
-
-RUN mkdir -p typings frontend backend && chown -R node:node /app
-
-USER node
-
-COPY --chown=node:node frontend/package*.json ./frontend/
-COPY --chown=node:node backend/package*.json ./backend/
-COPY --chown=node:node typings/package*.json ./typings/
-COPY --chown=node:node . .
-
-ARG BASE_HREF=/
-
-# Prepare project
-RUN chmod +x prepare.sh && \
-	sh ./prepare.sh --typings --frontend --webcomponent --backend
-
-# Clean up
-RUN rm -rf frontend/node_modules backend/node_modules && \
-	rm -rf typings
-
-# ====================================================
-# Stage 2: production
-# ====================================================
-FROM node:22.19.0-alpine3.21 AS production
-
-WORKDIR /opt/openvidu-meet
-
-COPY backend/package*.json ./
-RUN npm ci --production
-
-# Copy the frontend and backend from the builder
-COPY --from=builder /app/backend/dist ./dist
-COPY --from=builder /app/backend/public ./dist/public
-
-COPY docker/entrypoint.sh /usr/local/bin/entrypoint.sh
-
-RUN chmod +x /usr/local/bin/entrypoint.sh && \
-	chown -R node:node /opt/openvidu-meet
-
-ENV NODE_ENV=production
-
-EXPOSE $SERVER_PORT
-
-CMD ["/usr/local/bin/entrypoint.sh"]

docker/create_image.sh

@@ -1,11 +0,0 @@
-#!/bin/bash -x
-
-IMAGE=${1:-?echo "Error: You need to specify an image name as first argument"?}
-if [[ -n $IMAGE ]]; then
-    cd ..
-    export BUILDKIT_PROGRESS=plain && \
-    docker build --pull --no-cache --rm=true -f docker/Dockerfile -t "$IMAGE" --build-arg BASE_HREF=/ .
-    echo "Docker image '$IMAGE' built successfully."
-else
-    echo "Error: You need to specify an image name as first argument"
-fi

docker/create_image_demos.sh

@@ -1,9 +0,0 @@
-#!/bin/bash -x
-
-IMAGE="${1:-?echo "Error: You need to specify an image name as first argument"?}"
-if [[ -n $IMAGE ]]; then
-    cd ..
-    export BUILDKIT_PROGRESS=plain && docker build --pull --no-cache --rm=true -f docker/Dockerfile -t "$IMAGE"-demos --build-arg BASE_HREF=/openvidu-meet/ .
-else
-    echo "Error: You need to specify the image name as first argument"
-fi

frontend/package.json

@@ -1,85 +0,0 @@
-{
-  "name": "openvidu-meet-frontend",
-  "version": "3.4.1",
-  "scripts": {
-    "start:dev": "npx ng serve --configuration development --port=5080 --host=0.0.0.0",
-    "build:dev": "npx ng build --configuration development --watch",
-    "build": "func() { ./node_modules/@angular/cli/bin/ng.js build --configuration production --base-href=\"${1:-/}\"; }; func",
-    "typings:sync": "npm run sync-ce --prefix ../typings",
-    "sync:backend": "npx ng build --configuration production --output-path ../backend/dist/public/",
-    "e2e:run-all": "npx mocha --recursive --timeout 30000 ./tests/e2e/**/*.test.ts",
-    "e2e:run-routes": "npx mocha --recursive --timeout 30000 ./tests/e2e/routes.test.ts",
-    "e2e:run-home": "npx mocha ./tests/e2e/home.test.ts",
-    "e2e:run-recordings": "npx mocha --recursive --timeout 30000 ./tests/e2e/recording.test.ts",
-    "e2e:run-auth": "npx mocha --recursive --timeout 30000 ./tests/e2e/auth.test.ts",
-    "lib:serve": "npx ng build shared-meet-components --watch",
-    "lib:build": "ng build shared-meet-components --configuration production",
-    "lib:pack": "cd dist/shared-meet-components && npm pack",
-    "lib:sync-pro": "npm run lib:build && npm run lib:pack && cp dist/shared-meet-components/shared-meet-components-**.tgz ../../openvidu-meet-pro/frontend",
-    "test:unit": "ng test openvidu-meet --watch=false --code-coverage",
-    "webcomponent:build": "npm run build --prefix webcomponent",
-    "webcomponent:unit-test": "node --experimental-vm-modules node_modules/.bin/jest --config jest.config.mjs",
-    "lint:fix": "eslint src --fix",
-    "format:code": "prettier --ignore-path ../gitignore . --write"
-  },
-  "dependencies": {
-    "@angular/animations": "20.3.3",
-    "@angular/cdk": "20.2.7",
-    "@angular/common": "20.3.3",
-    "@angular/compiler": "20.3.3",
-    "@angular/core": "20.3.3",
-    "@angular/forms": "20.3.3",
-    "@angular/material": "20.2.7",
-    "@angular/platform-browser": "20.3.3",
-    "@angular/platform-browser-dynamic": "20.3.3",
-    "@angular/router": "20.3.3",
-    "core-js": "3.45.1",
-    "jwt-decode": "4.0.0",
-    "openvidu-components-angular": "file:openvidu-components-angular-3.4.0.tgz",
-    "rxjs": "7.8.2",
-    "tslib": "2.8.1",
-    "unique-names-generator": "4.7.1",
-    "zone.js": "0.15.1"
-  },
-  "devDependencies": {
-    "@angular-builders/custom-webpack": "20.0.0",
-    "@angular-devkit/build-angular": "20.3.4",
-    "@angular-eslint/builder": "20.3.0",
-    "@angular-eslint/eslint-plugin": "20.3.0",
-    "@angular-eslint/eslint-plugin-template": "20.3.0",
-    "@angular-eslint/schematics": "20.3.0",
-    "@angular-eslint/template-parser": "20.3.0",
-    "@angular/cli": "20.3.4",
-    "@angular/compiler-cli": "20.3.3",
-    "@types/chai": "4.3.20",
-    "@types/fluent-ffmpeg": "2.1.27",
-    "@types/jasmine": "5.1.9",
-    "@types/mocha": "9.1.1",
-    "@types/node": "22.18.8",
-    "@types/pixelmatch": "5.2.6",
-    "@types/pngjs": "6.0.5",
-    "@types/selenium-webdriver": "4.35.1",
-    "@typescript-eslint/eslint-plugin": "7.18.0",
-    "@typescript-eslint/parser": "7.18.0",
-    "chai": "4.5.0",
-    "chromedriver": "141.0.0",
-    "cross-env": "7.0.3",
-    "eslint": "8.57.1",
-    "eslint-config-prettier": "9.1.0",
-    "fluent-ffmpeg": "2.1.3",
-    "jasmine-core": "5.6.0",
-    "jasmine-spec-reporter": "7.0.0",
-    "karma": "6.4.4",
-    "karma-chrome-launcher": "3.2.0",
-    "karma-coverage": "2.2.1",
-    "karma-jasmine": "5.1.0",
-    "karma-jasmine-html-reporter": "2.1.0",
-    "mocha": "10.7.3",
-    "ng-packagr": "20.3.0",
-    "prettier": "3.3.3",
-    "selenium-webdriver": "4.25.0",
-    "ts-node": "10.9.2",
-    "tslib": "2.6.3",
-    "typescript": "5.8.3"
-  }
-}

frontend/projects/shared-meet-components/package.json

@@ -1,19 +0,0 @@
-{
-	"name": "shared-meet-components",
-	"version": "0.0.1",
-	"peerDependencies": {
-		"@angular/animations": "^18.0.0",
-		"@angular/cdk": "^18.0.0",
-		"@angular/common": "^18.2.0",
-		"@angular/core": "^18.2.0",
-		"@angular/forms": "^18.0.0",
-		"@angular/material": " ^18.0.0",
-		"jwt-decode": "^4.0.0",
-		"openvidu-components-angular": "^3.0.0",
-		"rxjs": "7.8.2"
-	},
-	"dependencies": {
-		"tslib": "^2.3.0"
-	},
-	"sideEffects": false
-}

meet-ce/backend/README.md

@@ -7,8 +7,8 @@ This is the backend of OpenVidu Meet. It is a Node.js application that uses [Exp
 For running the backend you need to have installed [Node.js](https://nodejs.org/). Then, you can run the following commands:
 
 ```bash
-npm install
+pnpm install
-npm run start:dev
+pnpm run start:dev
 ```
 
 This will start the backend in development mode. The server will listen on port 6080.
@@ -19,8 +19,8 @@ You can change the port and other default values in the file `src/config.ts`.
 For building the backend you can run the following command:
 
 ```bash
-npm install
+pnpm install
-npm run build:prod
+pnpm run build:prod
 ```
 
 ## Storage Structure

meet-ce/backend/jest.config.mjs

@@ -11,14 +11,14 @@ const jestConfig = {
 	testMatch: ['**/?(*.)+(spec|test).[tj]s?(x)'],
 	moduleFileExtensions: ['js', 'ts', 'json', 'node'],
 	testEnvironment: 'node',
-	moduleNameMapper: {
-		'^@typings-ce$': '<rootDir>/src/typings/ce/index.ts'
-	},
 	globals: {
 		'ts-jest': {
 			tsconfig: 'tsconfig.json'
 		}
-	}
+	},
+	moduleNameMapper: {
+		'^@openvidu-meet/typings$': '<rootDir>/../typings/src/index.ts'
+	},
 	// transform: {
 	// 	'^.+\\.tsx?$': ['ts-jest', {
 	// 	  // Opcionalmente, especifica el archivo tsconfig si es necesario

meet-ce/backend/nodemon.docs.json

@@ -0,0 +1,6 @@
+{
+	"watch": ["openapi/**/*.yaml", "openapi/**/*.yml"],
+	"ext": "yaml,yml",
+	"ignore": [],
+	"exec": "pnpm --filter openvidu-meet-backend run doc:api && pnpm --filter openvidu-meet-backend run doc:internal-api && echo '✅ OpenVidu Meet REST API docs updated successfully!'"
+}