diff --git a/.php-cs-fixer.php b/.php-cs-fixer.php index 555efe4b..5cf32bb6 100644 --- a/.php-cs-fixer.php +++ b/.php-cs-fixer.php @@ -5,7 +5,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,13 +20,14 @@ * with BigBlueButton; if not, see . */ +use BigBlueButton\Util\StrlenFixer; use PhpCsFixer\Config; use PhpCsFixer\Finder; $header = <<<'EOF' BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. - Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software @@ -53,10 +54,26 @@ $config = new Config(); $config ->setRiskyAllowed(true) + ->registerCustomFixers([ + new StrlenFixer(), + ]) ->setRules([ '@PhpCsFixer' => true, - '@PHP74Migration' => true, - 'general_phpdoc_annotation_remove' => ['annotations' => ['expectedDeprecation']], // one should use PHPUnit built-in method instead + '@PHP8x2Migration' => true, + + // Cleanliness + 'no_unused_imports' => true, + 'ordered_imports' => ['sort_algorithm' => 'alpha'], + 'no_empty_comment' => true, + 'no_empty_statement' => true, + + // Formatting + 'blank_line_before_statement' => ['statements' => ['return', 'if', 'try', 'throw']], + 'method_argument_space' => ['on_multiline' => 'ensure_fully_multiline'], + 'single_line_throw' => true, + + // Imported + 'general_phpdoc_annotation_remove' => ['annotations' => ['expectedDeprecation']], 'header_comment' => ['header' => $header], 'concat_space' => ['spacing' => 'one'], 'function_declaration' => ['closure_function_spacing' => 'none'], @@ -71,6 +88,7 @@ ], ], 'php_unit_test_class_requires_covers' => false, + 'BigBlueButton/do_not_change_strlen' => true, ]) ->setFinder($finder) ; diff --git a/.scrutinizer.yml b/.scrutinizer.yml index b992527d..fc802a78 100644 --- a/.scrutinizer.yml +++ b/.scrutinizer.yml @@ -5,7 +5,7 @@ build: override: true environment: php: - version: 8.1 + version: 8.2 compile_options: '--with-openssl --with-curl --enable-mbstring --enable-mbregex --enable-bcmath --with-mhash --with-xmlrpc --enable-opcache --enable-intl --with-pear --enable-fpm --with-zlib-dir --enable-inline-optimization --with-bz2 --with-zlib' tests: override: diff --git a/README.md b/README.md index 2e5fbc66..29f5a975 100644 --- a/README.md +++ b/README.md @@ -1,100 +1,152 @@ # BigBlueButton API for PHP -![Home Image](https://raw.githubusercontent.com/wiki/bigbluebutton/bigbluebutton-api-php/images/header.png) -[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fbigbluebutton%2Fbigbluebutton-api-php.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fbigbluebutton%2Fbigbluebutton-api-php?ref=badge_shield) - -The official and easy to use **BigBlueButton API for PHP**, makes easy for developers to use [BigBlueButton][bbb] API for **PHP 7.4+**. +![Header Image](https://raw.githubusercontent.com/wiki/bigbluebutton/bigbluebutton-api-php/images/header.png) -![Packagist](https://img.shields.io/packagist/v/bigbluebutton/bigbluebutton-api-php.svg?label=release) -![PHP from Travis config](https://img.shields.io/travis/php-v/bigbluebutton/bigbluebutton-api-php.svg) -[![Downloads](https://img.shields.io/packagist/dt/bigbluebutton/bigbluebutton-api-php.svg?style=flat-square)](https://packagist.org/packages/bigbluebutton/bigbluebutton-api-php) +[![Latest Release](https://img.shields.io/packagist/v/bigbluebutton/bigbluebutton-api-php?label=Release&logo=packagist)](https://packagist.org/packages/bigbluebutton/bigbluebutton-api-php) +[![Downloads](https://img.shields.io/packagist/dt/bigbluebutton/bigbluebutton-api-php?label=Downloads)](https://packagist.org/packages/bigbluebutton/bigbluebutton-api-php) +[![PHP Version](https://img.shields.io/badge/PHP-8.2%2B-blue?logo=php)](https://www.php.net/supported-versions.php) +[![License](https://img.shields.io/github/license/bigbluebutton/bigbluebutton-api-php?color=brightgreen)](LICENSE) +[![Last Commit](https://img.shields.io/github/last-commit/bigbluebutton/bigbluebutton-api-php)](https://github.com/bigbluebutton/bigbluebutton-api-php/commits) +[![Open Issues](https://img.shields.io/github/issues/bigbluebutton/bigbluebutton-api-php)](https://github.com/bigbluebutton/bigbluebutton-api-php/issues) [![Build Status](https://scrutinizer-ci.com/g/bigbluebutton/bigbluebutton-api-php/badges/build.png?b=master)](https://scrutinizer-ci.com/g/bigbluebutton/bigbluebutton-api-php/build-status/master) [![Code Coverage](https://scrutinizer-ci.com/g/bigbluebutton/bigbluebutton-api-php/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/bigbluebutton/bigbluebutton-api-php/?branch=master) -[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/bigbluebutton/bigbluebutton-api-php/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/bigbluebutton/bigbluebutton-api-php/?branch=master) +[![Code Quality](https://scrutinizer-ci.com/g/bigbluebutton/bigbluebutton-api-php/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/bigbluebutton/bigbluebutton-api-php/?branch=master) + +[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fbigbluebutton%2Fbigbluebutton-api-php.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fbigbluebutton%2Fbigbluebutton-api-php?ref=badge_shield) +[![Website](https://img.shields.io/website-up-down-green-red/http/bigbluebutton.org.svg?label=bigbluebutton.org)](http://bigbluebutton.org) +[![Follow @bigbluebutton](https://img.shields.io/badge/Twitter-%40bigbluebutton-blue?logo=twitter)](https://twitter.com/bigbluebutton) + +--- -[![@bigbluebutton on Twitter](https://img.shields.io/badge/twitter-%40bigbluebutton-blue.svg?style=flat)](https://twitter.com/bigbluebutton) -![Website](https://img.shields.io/website-up-down-green-red/http/bigbluebutton.org.svg?label=BigBlueButton.org) +The official **BigBlueButton PHP API Client** provides a developer-friendly wrapper to interact with +the **BigBlueButton** API. Built for **PHP 8.2+**, this library simplifies integration and management of +BigBlueButton servers in your PHP applications. -[![PHP 7.4](https://img.shields.io/badge/php-7.4-f33.svg?style=flat-square)](https://www.php.net/supported-versions.php) -[![PHP 8.0](https://img.shields.io/badge/php-8.0-f93.svg?style=flat-square)](https://www.php.net/supported-versions.php) -[![PHP 8.1](https://img.shields.io/badge/php-8.1-9c9.svg?style=flat-square)](https://www.php.net/supported-versions.php) -[![PHP 8.2](https://img.shields.io/badge/php-8.2-9c9.svg?style=flat-square)](https://www.php.net/supported-versions.php) +## Installation and Usage -## Installation and usage +Please see the [documentation](./docs/Home.md) to know how to install and use this PHP-Client to interact with the API of a BigBlueButton-Server. -The [wiki] contains all the documentation related to the PHP library. We have also written a samples to show a full -install and usage example. +## ๐Ÿ“ฆ Installation & Usage -## Submitting bugs and feature requests Bugs and feature request are tracked on [GitHub](https://github.com/bigbluebutton/bigbluebutton-api-php/issues) +## Build the documentation + +To build the documentation you need to install `Rust` and `mdbook` + +```bash +curl https://sh.rustup.rs -sSf | sh -s -- -y +source "$HOME/.cargo/env" +cargo install mdbook +``` + ## Contributing guidelines ### Code Quality 1: Style Make sure the code style configuration is applied by running PHPCS-Fixer. ```bash -# using an alias -$ composer cs-fix +composer require bigbluebutton/bigbluebutton-api-php ``` -### Code Quality 2: Static code analysis -PHPStan shall be used for static code analysis by running the command below: +--- + +## ๐Ÿž Issues & Feature Requests + +Please use the [GitHub Issues](https://github.com/bigbluebutton/bigbluebutton-api-php/issues) tracker to report bugs or +suggest new features. + +--- + +## ๐Ÿงช Code Quality & Testing + +This project follows strict code quality checks before allowing commits. Here's how to contribute effectively: + +### 1. Coding Style ```bash -# using an alias -$ composer code-check +# Using Composer alias +composer code-fix -# or the same w/o alias -$ ./vendor/bin/phpstan analyse +# Or directly +PHP_CS_FIXER_IGNORE_ENV=1 ./vendor/bin/php-cs-fixer fix --allow-risky yes ``` -### Code Quality 3: Tests - -For every implemented feature add unit tests and check all is green by running the command below. +### 2. Static Analysis ```bash +composer code-check +# Or +./vendor/bin/phpstan analyse +``` + # using an alias $ composer code-test # or the same w/o alias -./vendor/bin/phpunit +$ ./vendor/bin/phpunit ``` -To run a single test +To run a specific test: ```bash # using an alias $ composer code-test -- --filter BigBlueButtonTest::testApiVersion # or the same w/o alias -./vendor/bin/phpunit --filter BigBlueButtonTest::testApiVersion +$ ./vendor/bin/phpunit --filter BigBlueButtonTest::testApiVersion ``` -A code-coverage report will be created along with the tests. This report will be stored in: -```` -./var/coverage/ -```` -In case of trouble with the creation of the code-coverage report (e.g. local environment does not fulfill requirements) -the creation can be skipped with: + +To skip code coverage: + ```bash -# using an alias -$ composer code-test -- --no-coverage +composer code-test -- --no-coverage +``` + +> **Coverage reports are stored in:** `./var/coverage/` + +### 4. Configuration + +To connect tests to your own BigBlueButton server, copy `.env` to `.env.local` and configure: + +```env +BBB_SERVER_BASE_URL=https://your-bbb-server.example.com/bigbluebutton/ +BBB_SECRET=your-secret +``` + +--- + +## โœ… Pre-Commit Checks (CaptainHook) + +We use [CaptainHook](https://github.com/captainhookphp/captainhook) to enforce code quality: + +- โœ”๏ธ Commit message format ([beams](https://cbea.ms/git-commit/)) +- โœ”๏ธ Code style (PHPCS-Fixer) +- โœ”๏ธ Static analysis (PHPStan) +- โœ”๏ธ PHPUnit tests + +You can manually run all pre-commit checks to avoid errors: + +```bash +composer code-fix +composer code-check +composer code-test +``` + +> **Do not** skip checks using `--no-verify` unless absolutely necessary. + +> CaptainHook should be installed automatically after the first composer install. If not: + +```bash +vendor/bin/captainhook install ``` -**Remark:** +--- -Some test will connect to an existing BBB-server, which is specified in the `.env`-file. You -can specify your own BBB-server by copy that file into the same folder and name it `.env.local`. -Exchange the credentials `BBB_SERVER_BASE_URL` and `BBB_SECRET` to your server's values. -Since this new file (`.env.local`) takes precedence over the main file (`.env`), you will now test -with your own server. +## ๐Ÿ“ License -[bbb]: http://bigbluebutton.org -[composer]: https://getcomposer.org -[INSTALL]: samples/README.md -[wiki]: https://github.com/bigbluebutton/bigbluebutton-api-php/wiki +This project is licensed under the terms of the [LGPL-3.0](LICENSE). -## License -[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fbigbluebutton%2Fbigbluebutton-api-php.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fbigbluebutton%2Fbigbluebutton-api-php?ref=badge_large) \ No newline at end of file +[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fbigbluebutton%2Fbigbluebutton-api-php.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fbigbluebutton%2Fbigbluebutton-api-php?ref=badge_large) diff --git a/captainhook.json b/captainhook.json new file mode 100644 index 00000000..bd5e943e --- /dev/null +++ b/captainhook.json @@ -0,0 +1,59 @@ +{ + "commit-msg": { + "enabled": true, + "actions": [ + { + "action": "\\CaptainHook\\App\\Hook\\Message\\Action\\Beams", + "options": { + "subjectLength": 50, + "bodyLineLength": 72 + } + } + ] + }, + "pre-push": { + "enabled": false, + "actions": [] + }, + "pre-commit": { + "enabled": true, + "actions": [ + { + "action": "\\CaptainHook\\App\\Hook\\PHP\\Action\\Linting" + }, + { + "action": "composer code-fix -- --dry-run --verbose --show-progress=none" + }, + { + "action": "composer code-check" + }, + { + "action": "composer code-test -- --stop-on-failure" + } + ] + }, + "prepare-commit-msg": { + "enabled": false, + "actions": [] + }, + "post-commit": { + "enabled": false, + "actions": [] + }, + "post-merge": { + "enabled": false, + "actions": [] + }, + "post-checkout": { + "enabled": false, + "actions": [] + }, + "post-rewrite": { + "enabled": false, + "actions": [] + }, + "post-change": { + "enabled": false, + "actions": [] + } +} diff --git a/composer.json b/composer.json index fa989434..9651d174 100644 --- a/composer.json +++ b/composer.json @@ -14,6 +14,11 @@ "name": "Ghazi Triki", "email": "ghazi.triki@riadvice.tn", "role": "Developer" + }, + { + "name": "Tim Korn", + "email": "korn@aufKurs.de", + "role": "Developer" } ], "repositories": { @@ -23,37 +28,34 @@ } }, "require": { - "php": ">=7.4", + "php": ">=8.2", "ext-curl": "*", - "ext-simplexml": "*", - "ext-mbstring": "*", "ext-json": "*", - "marc-mabe/php-enum": "^v4.7.0" + "ext-mbstring": "*", + "ext-simplexml": "*" }, "require-dev": { - "phpunit/phpunit": "^9.6.16", - "fakerphp/faker": "^v1.23.1", - "friendsofphp/php-cs-fixer": "^v3.48.0", - "squizlabs/php_codesniffer": "^3.8.1", - "phploc/phploc": "^7.0.2", - "nunomaduro/phpinsights": "^v2.11.0", - "bmitch/churn-php": "^1.7.1", - "phpmetrics/phpmetrics": "^v2.8.2", - "wapmorgan/php-deprecation-detector": "^2.0.33", + "bmitch/churn-php": "^1.7", + "captainhook/captainhook": "^5.23", + "captainhook/hook-installer": "^1.0", + "fakerphp/faker": "^1.23", + "friendsofphp/php-cs-fixer": "^3.54", + "nunomaduro/phpinsights": "^2.11", "phpstan/phpstan": "^1.10", - "tracy/tracy": "^2.9", + "phpunit/php-code-coverage": "^10.1", + "phpunit/phpunit": "^10.5", + "squizlabs/php_codesniffer": "^3.9", + "tracy/tracy": "^2.10", "vlucas/phpdotenv": "^5.6", - "phpunit/php-code-coverage": "9.2.30" + "wapmorgan/php-deprecation-detector": "^2.0" }, "scripts": { "code-check": "./vendor/bin/phpstan analyse", "code-test": "./vendor/bin/phpunit", - "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 ./vendor/bin/php-cs-fixer fix --allow-risky yes", + "code-fix": "PHP_CS_FIXER_IGNORE_ENV=1 ./vendor/bin/php-cs-fixer fix --allow-risky yes", "sniffer": "./vendor/bin/phpcs src/", - "phploc": "./vendor/bin/phploc src/", "phpinsights": "./vendor/bin/phpinsights", - "phpdd": "./vendor/bin/phpdd --target 7.4 src/", - "phpmetrics": "./vendor/bin/phpmetrics --report-html=metrics src/", + "phpdd": "./vendor/bin/phpdd --target 8.0 src/", "churn": "./vendor/bin/churn run src/" }, "options": { @@ -68,13 +70,17 @@ "psr-4": { "BigBlueButton\\": [ "src", + "dev", "tests" ] } }, "config": { + "sort-packages": true, "allow-plugins": { - "dealerdirect/phpcodesniffer-composer-installer": true + "dealerdirect/phpcodesniffer-composer-installer": true, + "captainhook/captainhook-phar": true, + "captainhook/hook-installer": true } } } diff --git a/dev/Util/StrlenFixer.php b/dev/Util/StrlenFixer.php new file mode 100644 index 00000000..3b2df25c --- /dev/null +++ b/dev/Util/StrlenFixer.php @@ -0,0 +1,111 @@ +. + */ + +namespace BigBlueButton\Util; + +use PhpCsFixer\Fixer\FixerInterface; +use PhpCsFixer\FixerDefinition\CodeSample; +use PhpCsFixer\FixerDefinition\FixerDefinition; +use PhpCsFixer\FixerDefinition\FixerDefinitionInterface; +use PhpCsFixer\Tokenizer\Token; +use PhpCsFixer\Tokenizer\Tokens; + +/** + * @codeCoverageIgnore + */ +class StrlenFixer implements FixerInterface +{ + public function isCandidate(Tokens $tokens): bool + { + return true; + } + + public function isRisky(): bool + { + return true; + } + + public function fix(\SplFileInfo $file, Tokens $tokens): void + { + // Replace the line 'Content-length: ' . mb_strlen($payload), with 'Content-length: ' . strlen($payload), + foreach ($tokens as $index => $token) { + if (null === $token) { + continue; + } + + // check if token has expected string + if (!str_contains($token->getContent(), "'Content-length:")) { + continue; + } + + // check if next token is '.' + $nextTokenPosition = $tokens->getNextMeaningfulToken($index); + if (null === $nextTokenPosition) { + continue; + } + $nextToken = $tokens[$nextTokenPosition]; + if ('.' !== $nextToken->getContent()) { + continue; + } + + // check if next token is 'mb_strlen' + $nextTokenPosition = $tokens->getNextMeaningfulToken($nextTokenPosition); + if (null === $nextTokenPosition) { + continue; + } + $nextToken = $tokens[$nextTokenPosition]; + if ('mb_strlen' !== $nextToken->getContent()) { + continue; + } + + // We have a match: Adapt the token + $tokens[$nextTokenPosition] = new Token([T_STRING, 'strlen']); + } + } + + public function getDefinition(): FixerDefinitionInterface + { + return new FixerDefinition( + 'Will ensure that strlen() is not replaced by mb_strlen().', + [ + new CodeSample(' [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! \ No newline at end of file diff --git a/docs/src/api_calls/client_settings_override.md b/docs/src/api_calls/client_settings_override.md new file mode 100644 index 00000000..386773a5 --- /dev/null +++ b/docs/src/api_calls/client_settings_override.md @@ -0,0 +1,341 @@ +{{#include ../header.md}} + +# Client Settings Override + +The Client Settings Override feature allows you to customize the HTML5 client behavior for specific meetings by overriding settings from the server's `settings.yml` file. This feature is available in BigBlueButton 3.0.0 and later. + +## Overview + +Client settings override provides a way to: +- Customize the application name and appearance +- Configure WebRTC and media settings +- Modify user interface behavior +- Set custom themes and branding +- Override locale and language settings + +> [!IMPORTANT] +> For security reasons, this feature is disabled by default. You must explicitly enable it by setting `allowOverrideClientSettingsOnCreateCall=true`. + +## Core Classes + +### ClientSettingsOverride + +The main class for handling client settings override. + +```php +use BigBlueButton\Core\ClientSettingsOverride; +``` + +#### Constructor + +```php +public function __construct(array $settings = []) +``` + +Creates a new ClientSettingsOverride instance with optional initial settings. + +**Parameters:** +- `$settings` (array) - Initial settings array + +#### Methods + +##### setSettings() + +```php +public function setSettings(array $settings): self +``` + +Sets all settings at once. + +**Parameters:** +- `$settings` (array) - The settings array + +##### getSettings() + +```php +public function getSettings(): array +``` + +Returns all settings as an array. + +##### setSetting() + +```php +public function setSetting(string $key, mixed $value): self +``` + +Sets a specific setting using dot notation. + +**Parameters:** +- `$key` (string) - The setting key (e.g., 'public.app.appName') +- `$value` (mixed) - The setting value + +##### getSetting() + +```php +public function getSetting(string $key, mixed $default = null): mixed +``` + +Gets a specific setting using dot notation. + +**Parameters:** +- `$key` (string) - The setting key +- `$default` (mixed) - Default value if key doesn't exist + +##### removeSetting() + +```php +public function removeSetting(string $key): self +``` + +Removes a specific setting using dot notation. + +**Parameters:** +- `$key` (string) - The setting key to remove + +##### toXML() + +```php +public function toXML(): string +``` + +Converts the settings to XML format for the BigBlueButton API request. + +##### fromJson() + +```php +public static function fromJson(string $jsonString): self +``` + +Creates a ClientSettingsOverride instance from a JSON string. + +**Parameters:** +- `$jsonString` (string) - Valid JSON string containing settings + +**Throws:** +- `\InvalidArgumentException` if JSON is invalid + +## Integration with CreateMeetingParameters + +The ClientSettingsOverride is used with the CreateMeetingParameters class: + +### setAllowOverrideClientSettingsOnCreateCall() + +```php +public function setAllowOverrideClientSettingsOnCreateCall(bool $allow): self +``` + +Enables or disables the client settings override feature. + +### setClientSettingsOverride() + +```php +public function setClientSettingsOverride(?ClientSettingsOverride $override): self +``` + +Sets the client settings override for the meeting. + +### getClientSettingsOverride() + +```php +public function getClientSettingsOverride(): ?ClientSettingsOverride +``` + +Returns the current client settings override. + +## Usage Examples + +### Basic Example + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\CreateMeetingParameters; +use BigBlueButton\Core\ClientSettingsOverride; + +$bbb = new BigBlueButton(); +$createParams = new CreateMeetingParameters('meeting123', 'Test Meeting'); + +// Enable client settings override +$createParams->setAllowOverrideClientSettingsOnCreateCall(true); + +// Create settings override +$settings = new ClientSettingsOverride([ + 'public' => [ + 'app' => [ + 'appName' => 'Custom Meeting Name', + 'helpLink' => 'https://help.example.com' + ] + ] +]); + +// Apply settings +$createParams->setClientSettingsOverride($settings); + +// Create meeting +$response = $bbb->createMeeting($createParams); +``` + +### Advanced Configuration + +```php +$settings = new ClientSettingsOverride(); + +// Application settings +$settings->setSetting('public.app.appName', 'Enterprise Meeting'); +$settings->setSetting('public.app.helpLink', 'https://support.company.com'); +$settings->setSetting('public.app.autoJoin', false); +$settings->setSetting('public.app.askForConfirmationOnLeave', true); +$settings->setSetting('public.app.userSettingsStorage', 'localStorage'); + +// WebRTC settings +$settings->setSetting('public.kurento.wsUrl', 'wss://webrtc.company.com/sfu'); +$settings->setSetting('public.kurento.turnUrl', 'turn:turn.company.com:443'); + +// Media settings +$settings->setSetting('public.media.sipjsHackViaWs', false); +$settings->setSetting('public.media.audio.codec', 'opus'); +$settings->setSetting('public.media.video.codec', 'vp8'); + +// Theme settings +$settings->setSetting('public.theme.branding.target', '.branding-element'); +$settings->setSetting('public.theme.custom_css_url', 'https://assets.company.com/theme.css'); + +// Locale settings +$settings->setSetting('public.defaultSettings.application.overrideLocale', 'fr'); + +$createParams->setClientSettingsOverride($settings); +``` + +### JSON Configuration + +```php +$jsonConfig = '{ + "public": { + "app": { + "appName": "JSON Configured Meeting", + "helpLink": "https://docs.example.com", + "autoJoin": true + }, + "kurento": { + "wsUrl": "wss://webrtc.example.com/sfu" + }, + "theme": { + "branding": { + "target": ".custom-branding" + } + } + } +}'; + +$settings = ClientSettingsOverride::fromJson($jsonConfig); +$createParams->setClientSettingsOverride($settings); +``` + +## Available Settings + +### Application Settings (`public.app`) + +| Setting | Type | Description | +|---------|------|-------------| +| `appName` | string | Custom application name | +| `helpLink` | string | Custom help documentation URL | +| `autoJoin` | boolean | Auto-join meeting when page loads | +| `askForConfirmationOnLeave` | boolean | Show confirmation dialog when leaving | +| `userSettingsStorage` | string | Storage type: 'localStorage', 'sessionStorage', 'cookie' | +| `displayBrandingArea` | boolean | Show/hide branding area | + +### WebRTC Settings (`public.kurento`) + +| Setting | Type | Description | +|---------|------|-------------| +| `wsUrl` | string | Custom WebRTC SFU WebSocket URL | +| `turnUrl` | string | Custom TURN server URL | +| `turnUsername` | string | TURN server username | +| `turnCredential` | string | TURN server credential | + +### Media Settings (`public.media`) + +| Setting | Type | Description | +|---------|------|-------------| +| `sipjsHackViaWs` | boolean | Enable SIP.js WebSocket hack | +| `audio.codec` | string | Preferred audio codec: 'opus', 'pcmu', 'pcma' | +| `video.codec` | string | Preferred video codec: 'vp8', 'vp9', 'h264' | +| `video.resolution` | string | Preferred video resolution | + +### Theme Settings (`public.theme`) + +| Setting | Type | Description | +|---------|------|-------------| +| `branding.target` | string | CSS selector for branding elements | +| `custom_css_url` | string | URL to custom CSS file | +| `logo.url` | string | URL to custom logo image | +| `favicon.url` | string | URL to custom favicon | + +### Default Settings (`public.defaultSettings`) + +| Setting | Type | Description | +|---------|------|-------------| +| `application.overrideLocale` | string | Override locale (e.g., 'en', 'fr', 'es') | +| `application.chat.enabled` | boolean | Enable/disable chat | +| `application.poll.enabled` | boolean | Enable/disable polls | + +## Security Considerations + +1. **Enable Only When Needed**: Only enable `allowOverrideClientSettingsOnCreateCall` when you actually need to override settings. + +2. **Validate Input**: Always validate user-provided settings before applying them. + +3. **Sensitive Data**: Avoid exposing sensitive configuration through client settings override. + +4. **Network Security**: Ensure custom WebSocket URLs are from trusted sources. + +## Error Handling + +```php +try { + $settings = ClientSettingsOverride::fromJson($invalidJson); +} catch (\InvalidArgumentException $e) { + // Handle invalid JSON + error_log('Invalid JSON: ' . $e->getMessage()); + $settings = new ClientSettingsOverride(); // Fallback to empty settings +} +``` + +## Best Practices + +1. **Use Specific Settings**: Only override the settings you actually need to change. + +2. **Document Changes**: Keep track of which settings you're overriding for debugging purposes. + +3. **Test Thoroughly**: Test client settings override in a development environment before production use. + +4. **Fallback Values**: Provide sensible defaults when getting settings that might not exist. + +5. **Performance**: Avoid overly complex nested structures that might impact client performance. + +## Troubleshooting + +### Settings Not Applied +- Verify `allowOverrideClientSettingsOnCreateCall` is set to `true` +- Check that the settings structure matches the expected format +- Ensure the BigBlueButton server version supports client settings override (3.0.0+) + +### Invalid JSON +- Use `try-catch` blocks when calling `fromJson()` +- Validate JSON structure before processing + +### WebSocket Connection Issues +- Verify custom WebSocket URLs are accessible +- Check firewall and network configuration +- Ensure TURN server credentials are correct + +## Migration Notes + +If you're upgrading from an earlier version of BigBlueButton: + +1. Ensure your server is running BigBlueButton 3.0.0 or later +2. Update your PHP API library to the latest version +3. Review existing meeting creation code to add client settings override if needed +4. Test thoroughly in a development environment + +For more information about the available settings, refer to the official BigBlueButton documentation and your server's `settings.yml` file. diff --git a/docs/src/api_calls/feedback.md b/docs/src/api_calls/feedback.md new file mode 100644 index 00000000..a2c07f2c --- /dev/null +++ b/docs/src/api_calls/feedback.md @@ -0,0 +1,587 @@ +{{#include ../header.md}} + +# Feedback + +The feedback endpoint allows users to submit feedback about their meeting experience. This endpoint replaces the old `/html5client/feedback` endpoint with `/api/feedback`, providing a more standardized API approach for collecting user feedback. + +This feature is particularly useful for: +- **User Experience Improvement** - Collect structured feedback about meeting quality +- **Quality Assurance** - Monitor user satisfaction and identify issues +- **Analytics** - Gather data for improving the BigBlueButton platform +- **Support** - Allow users to report problems or suggestions + +## API Endpoint + +``` +POST http://yourserver.com/bigbluebutton/api/feedback?[parameters] +``` + +**Response Format:** JSON (application/json) + +## Parameters + +| Parameter | Type | Required | Description | +|-----------|------|----------|-------------| +| `sessionToken` | String | Yes | Session token to identify the user who is submitting feedback | +| `rating` | Integer | No | Numeric rating for the meeting experience (typically 1-5) | +| `comment` | String | No | Textual feedback or comments about the meeting experience | +| `meetingID` | String | No | Meeting ID for which the feedback is being submitted | +| `userID` | String | No | User ID of the person submitting the feedback | + +## Usage Examples + +### Basic Feedback Submission + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\FeedbackParameters; + +$bbb = new BigBlueButton(); + +// Submit basic feedback with just a session token +$feedbackParams = new FeedbackParameters('user-session-token-123'); + +$response = $bbb->feedback($feedbackParams); + +if ($response->success()) { + echo "Feedback submitted successfully!"; + echo "Feedback ID: " . $response->getFeedbackID(); + echo "Status: " . $response->getStatus(); +} else { + echo "Error: " . $response->getMessage(); +} +``` + +### Complete Feedback Submission + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\FeedbackParameters; + +$bbb = new BigBlueButton(); + +// Create comprehensive feedback +$feedbackParams = new FeedbackParameters('session-token-456'); +$feedbackParams->setRating(4); +$feedbackParams->setComment('Great meeting overall! Audio quality was excellent, but video could be smoother.'); +$feedbackParams->setMeetingID('weekly-team-meeting-001'); +$feedbackParams->setUserID('participant-john-doe'); + +$response = $bbb->feedback($feedbackParams); + +if ($response->success()) { + echo "Feedback submitted successfully!"; + echo "Feedback ID: " . $response->getFeedbackID(); + echo "Submitted at: " . $response->getSubmittedAt(); + echo "Processed: " . ($response->getProcessed() ? 'Yes' : 'No'); +} else { + echo "Error: " . $response->getMessage(); + echo "Status Code: " . $response->getStatusCode(); +} +``` + +### Mobile App Feedback + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\FeedbackParameters; + +$bbb = new BigBlueButton(); + +// Mobile app feedback with additional context +$feedbackParams = new FeedbackParameters('mobile-session-token-789'); +$feedbackParams->setRating(5); +$feedbackParams->setComment('Excellent mobile experience! The app worked perfectly on my tablet.'); +$feedbackParams->setMeetingID('mobile-presentation-123'); +$feedbackParams->setUserID('mobile-user-456'); + +$response = $bbb->feedback($feedbackParams); + +if ($response->success()) { + // Store feedback ID for follow-up + $feedbackId = $response->getFeedbackID(); + + // Could also store additional metadata locally + $feedbackData = [ + 'feedback_id' => $feedbackId, + 'session_token' => $response->getSessionToken(), + 'rating' => $response->getRating(), + 'comment' => $response->getComment(), + 'submitted_at' => $response->getSubmittedAt() + ]; + + echo "Mobile feedback submitted with ID: " . $feedbackId; +} +``` + +### Post-Meeting Feedback Collection + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\FeedbackParameters; + +function collectMeetingFeedback($sessionToken, $meetingId, $userId) { + $bbb = new BigBlueButton(); + + // Create feedback parameters + $feedbackParams = new FeedbackParameters($sessionToken); + $feedbackParams->setMeetingID($meetingId); + $feedbackParams->setUserID($userId); + + // In a real application, you would collect rating and comment from user input + $rating = $_POST['rating'] ?? null; // 1-5 star rating + $comment = $_POST['comment'] ?? ''; // User comments + + if ($rating !== null) { + $feedbackParams->setRating((int)$rating); + } + + if (!empty($comment)) { + $feedbackParams->setComment($comment); + } + + // Submit feedback + $response = $bbb->feedback($feedbackParams); + + return $response; +} + +// Usage after meeting ends +$sessionToken = 'user-session-from-meeting'; +$meetingId = 'meeting-that-just-ended'; +$userId = 'user-who-attended'; + +$feedbackResponse = collectMeetingFeedback($sessionToken, $meetingId, $userId); + +if ($feedbackResponse->success()) { + echo "Thank you for your feedback!"; +} else { + echo "Unable to submit feedback: " . $feedbackResponse->getMessage(); +} +``` + +### Batch Feedback Collection + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\FeedbackParameters; + +$bbb = new BigBlueButton(); + +// Collect feedback from multiple users +$sessionTokens = [ + 'user1-session-token', + 'user2-session-token', + 'user3-session-token' +]; + +$feedbackResults = []; + +foreach ($sessionTokens as $sessionToken) { + $feedbackParams = new FeedbackParameters($sessionToken); + $feedbackParams->setRating(rand(3, 5)); // Simulate different ratings + $feedbackParams->setComment('Automated feedback collection'); + $feedbackParams->setMeetingID('batch-feedback-meeting'); + + $response = $bbb->feedback($feedbackParams); + $feedbackResults[] = [ + 'session_token' => $sessionToken, + 'success' => $response->success(), + 'feedback_id' => $response->success() ? $response->getFeedbackID() : null, + 'message' => $response->getMessage() + ]; +} + +// Process results +$successful = array_filter($feedbackResults, fn($r) => $r['success']); +echo "Successfully submitted " . count($successful) . " out of " . count($feedbackResults) . " feedback entries."; +``` + +## Response Format + +The feedback API returns responses in JSON format with `application/json` content type. + +### Successful Response Example + +```json +{ + "status": "ok", + "feedback_id": "feedback-123456", + "session_token": "session-token-789", + "meeting_id": "meeting456", + "user_id": "user123", + "rating": 4, + "comment": "Great meeting experience!", + "submitted_at": "2023-01-15T14:30:00Z", + "processed": true, + "feedback_type": "meeting_feedback", + "additional_data": { + "device-type": "mobile", + "platform": "iOS" + } +} +``` + +### Minimal Response Example + +```json +{ + "status": "ok", + "feedback_id": "feedback-minimal-789", + "session_token": "minimal-session-token" +} +``` + +### Error Response Example + +```json +{ + "status": "error", + "message": "Invalid session token", + "statuscode": "404" +} +``` + +## Response Fields + +The FeedbackResponse provides the following fields: + +### Required Fields + +| Field | Type | Description | +|-------|------|-------------| +| `feedback_id` | String | Unique identifier for the feedback submission | +| `session_token` | String | The session token used for the feedback submission | + +### Optional Fields + +| Field | Type | Description | +|-------|------|-------------| +| `meeting_id` | String | Meeting ID if provided in the request | +| `user_id` | String | User ID if provided in the request | +| `rating` | Integer | Rating value if provided in the request | +| `comment` | String | Comment text if provided in the request | +| `submitted_at` | String | Timestamp when the feedback was submitted | +| `processed` | Boolean | Whether the feedback has been processed | +| `feedback_type` | String | Type/category of feedback | +| `additional_data` | Array | Additional metadata about the feedback | + +## Response Handling + +```php +$response = $bbb->feedback($feedbackParams); + +if ($response->success()) { + // Basic information + echo "Feedback ID: " . $response->getFeedbackID(); + echo "Session Token: " . $response->getSessionToken(); + + // Optional information + if ($response->getMeetingID()) { + echo "Meeting ID: " . $response->getMeetingID(); + } + + if ($response->getUserID()) { + echo "User ID: " . $response->getUserID(); + } + + if ($response->getRating()) { + echo "Rating: " . $response->getRating(); + } + + if ($response->getComment()) { + echo "Comment: " . $response->getComment(); + } + + if ($response->getSubmittedAt()) { + echo "Submitted At: " . $response->getSubmittedAt(); + } + + echo "Processed: " . ($response->getProcessed() ? 'Yes' : 'No'); + + // Additional data handling + $additionalData = $response->getAdditionalData(); + foreach ($additionalData as $key => $value) { + echo "Additional Data - {$key}: {$value}"; + } + +} else { + echo "Error: " . $response->getMessage(); + echo "Status Code: " . $response->getStatusCode(); +} +``` + +## Rating Guidelines + +When implementing rating collection, consider these standard practices: + +### 5-Star Rating Scale + +```php +function getRatingLabel($rating) { + $labels = [ + 1 => 'Very Poor', + 2 => 'Poor', + 3 => 'Average', + 4 => 'Good', + 5 => 'Excellent' + ]; + + return $labels[$rating] ?? 'Not Rated'; +} + +// Usage +$rating = 4; +echo "User rated the meeting: " . getRatingLabel($rating); +``` + +### Rating Validation + +```php +function validateRating($rating) { + // Rating should be between 1 and 5 + if ($rating !== null && ($rating < 1 || $rating > 5)) { + throw new InvalidArgumentException('Rating must be between 1 and 5'); + } + + return $rating; +} + +// Usage +try { + $rating = validateRating($_POST['rating']); + $feedbackParams->setRating($rating); +} catch (InvalidArgumentException $e) { + echo "Invalid rating: " . $e->getMessage(); +} +``` + +## Comment Guidelines + +### Comment Length Validation + +```php +function validateComment($comment) { + $maxLength = 1000; // Maximum comment length + + if (strlen($comment) > $maxLength) { + throw new InvalidArgumentException("Comment must be less than {$maxLength} characters"); + } + + // Remove excessive whitespace + $comment = preg_replace('/\s+/', ' ', trim($comment)); + + return $comment; +} + +// Usage +try { + $comment = validateComment($_POST['comment'] ?? ''); + if (!empty($comment)) { + $feedbackParams->setComment($comment); + } +} catch (InvalidArgumentException $e) { + echo "Invalid comment: " . $e->getMessage(); +} +``` + +### Comment Sanitization + +```php +function sanitizeComment($comment) { + // Basic sanitization - remove HTML tags and special characters + $comment = strip_tags($comment); + $comment = htmlspecialchars($comment, ENT_QUOTES, 'UTF-8'); + + return $comment; +} + +// Usage +$rawComment = $_POST['comment'] ?? ''; +$cleanComment = sanitizeComment($rawComment); +$feedbackParams->setComment($cleanComment); +``` + +## Error Handling + +Common error scenarios and their handling: + +```php +$response = $bbb->feedback($feedbackParams); + +if (!$response->success()) { + $message = $response->getMessage(); + $statusCode = $response->getStatusCode(); + + switch ($statusCode) { + case '400': + // Bad request - invalid parameters + echo "Invalid feedback parameters provided"; + break; + + case '401': + // Unauthorized - invalid checksum or secret + echo "Authentication failed"; + break; + + case '404': + // Not found - invalid session token + echo "Invalid or expired session token"; + break; + + case '429': + // Too many requests - rate limiting + echo "Too many feedback submissions. Please try again later."; + break; + + case '500': + // Internal server error + echo "Server error occurred. Please try again later."; + break; + + default: + echo "Unknown error: " . $message; + } +} +``` + +## Best Practices + +### 1. **Timing** +- Collect feedback immediately after the meeting ends +- Consider follow-up emails for longer feedback collection periods + +### 2. **User Experience** +- Keep the feedback form simple and quick to complete +- Use clear rating scales and descriptive labels +- Provide optional comment fields for detailed feedback + +### 3. **Data Privacy** +- Inform users about how their feedback will be used +- Consider anonymizing feedback data for analysis +- Follow data protection regulations (GDPR, CCPA, etc.) + +### 4. **Rate Limiting** +- Implement client-side rate limiting to prevent spam +- Consider server-side validation for multiple submissions + +### 5. **Error Handling** +- Provide clear error messages to users +- Implement retry logic for temporary failures +- Log feedback submission failures for debugging + +## Integration Examples + +### Web Application Integration + +```php +// In your meeting end controller +public function submitFeedback(Request $request) { + try { + $sessionToken = $request->input('session_token'); + $rating = $request->input('rating'); + $comment = $request->input('comment'); + + $feedbackParams = new FeedbackParameters($sessionToken); + + if ($rating) { + $feedbackParams->setRating((int)$rating); + } + + if ($comment) { + $feedbackParams->setComment($comment); + } + + $bbb = new BigBlueButton(); + $response = $bbb->feedback($feedbackParams); + + if ($response->success()) { + return response()->json([ + 'success' => true, + 'feedback_id' => $response->getFeedbackID(), + 'message' => 'Thank you for your feedback!' + ]); + } else { + return response()->json([ + 'success' => false, + 'message' => $response->getMessage() + ], 400); + } + + } catch (Exception $e) { + return response()->json([ + 'success' => false, + 'message' => 'An error occurred while submitting feedback' + ], 500); + } +} +``` + +### JavaScript/AJAX Integration + +```javascript +// Frontend feedback submission +function submitFeedback(sessionToken, rating, comment) { + const data = { + sessionToken: sessionToken, + rating: rating, + comment: comment + }; + + fetch('/api/feedback', { + method: 'POST', + headers: { + 'Content-Type': 'application/json', + }, + body: JSON.stringify(data) + }) + .then(response => response.json()) + .then(data => { + if (data.success) { + alert('Thank you for your feedback!'); + console.log('Feedback ID:', data.feedback_id); + } else { + alert('Error: ' + data.message); + } + }) + .catch(error => { + console.error('Error submitting feedback:', error); + alert('An error occurred while submitting feedback'); + }); +} + +// Usage +submitFeedback('user-session-token', 4, 'Great meeting experience!'); +``` + +## Analytics and Reporting + +### Feedback Summary + +```php +function generateFeedbackSummary($feedbackResponses) { + $totalFeedback = count($feedbackResponses); + $averageRating = 0; + $ratingDistribution = [1 => 0, 2 => 0, 3 => 0, 4 => 0, 5 => 0]; + + foreach ($feedbackResponses as $response) { + if ($response->getRating()) { + $rating = $response->getRating(); + $averageRating += $rating; + $ratingDistribution[$rating]++; + } + } + + if ($totalFeedback > 0) { + $averageRating = $averageRating / $totalFeedback; + } + + return [ + 'total_feedback' => $totalFeedback, + 'average_rating' => round($averageRating, 2), + 'rating_distribution' => $ratingDistribution + ]; +} +``` + +This feedback API provides a standardized way to collect user feedback, enabling continuous improvement of the BigBlueButton platform through structured user input. diff --git a/docs/src/api_calls/get_join_url.md b/docs/src/api_calls/get_join_url.md new file mode 100644 index 00000000..7350941c --- /dev/null +++ b/docs/src/api_calls/get_join_url.md @@ -0,0 +1,370 @@ +{{#include ../header.md}} + +# Get Join URL + +The getJoinUrl endpoint generates a new /join URL that can be used to create a new session for an existing user. By associating the new session token with the same user ID, all sessions will appear as the same user in the user list, ensuring accurate user counts. + +This feature is particularly useful for: +- **Hybrid environments** where multiple screens in the same room each require a distinct session with different layouts +- **Session transfers** enabling seamless user session transfers to another device (e.g., mobile device scanning a QR code displayed on a computer) +- **Multi-device scenarios** where a user wants to join the same meeting from multiple devices simultaneously + +## API Endpoint + +``` +GET http://yourserver.com/bigbluebutton/api/getJoinUrl?[parameters] +``` + +## Parameters + +| Parameter | Type | Required | Description | +|-----------|------|----------|-------------| +| `sessionToken` | String | Yes | Session token to identify the user who is requesting a new join URL | +| `replaceSession` | Boolean | No | When set to `true`, using the newly generated join URL will immediately invalidate the original session. Default: `false` | +| `sessionName` | String | No | Assign a descriptive name to the newly created session. Allows quick understanding of the session's origin or purpose when reviewing user's session history | +| `enforceLayout` | String | No | Specify a layout enforcement setting for the new session. Overrides the `enforceLayout` parameter inherited from the original user's session. If not specified, the new session inherits the layout behavior of the original session | +| `userdata-*` | String | No | Include additional user data parameters prefixed with `userdata-`. These parameters merge with the original user's existing userdata settings. New session parameters take precedence over duplicates | + +## Usage Examples + +### Basic Usage + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\GetJoinUrlParameters; + +$bbb = new BigBlueButton(); + +// Get a new join URL for an existing session +$getJoinUrlParams = new GetJoinUrlParameters('existing-session-token-123'); + +$response = $bbb->getJoinUrl($getJoinUrlParams); + +if ($response->success()) { + $newJoinUrl = $response->getUrl(); + echo "New join URL: " . $newJoinUrl; +} else { + echo "Error: " . $response->getMessage(); +} +``` + +### Advanced Usage with Session Replacement + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\GetJoinUrlParameters; +use BigBlueButton\Enum\MeetingLayout; + +$bbb = new BigBlueButton(); + +// Create parameters with session replacement +$getJoinUrlParams = new GetJoinUrlParameters('mobile-session-token-456'); + +// Replace the original session when the new one is used +$getJoinUrlParams->setReplaceSession(true); + +// Set a descriptive session name +$getJoinUrlParams->setSessionName('Mobile Device Transfer'); + +// Enforce a specific layout for the new session +$getJoinUrlParams->setEnforceLayout(MeetingLayout::VIDEO_FOCUS); + +// Add custom userdata parameters +$getJoinUrlParams->addMeta('userdata-device-type', 'mobile'); +$getJoinUrlParams->addMeta('userdata-transfer-source', 'desktop'); +$getJoinUrlParams->addMeta('userdata-screen-size', 'small'); + +$response = $bbb->getJoinUrl($getJoinUrlParams); + +if ($response->success()) { + echo "New join URL: " . $response->getUrl(); + echo "Session Token: " . $response->getSessionToken(); + echo "Session Name: " . $response->getSessionName(); + echo "Replace Session: " . ($response->isReplaceSession() ? 'Yes' : 'No'); +} else { + echo "Error: " . $response->getMessage(); +} +``` + +### QR Code Generation for Session Transfer + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\GetJoinUrlParameters; + +$bbb = new BigBlueButton(); + +// Generate a join URL for mobile device transfer +$getJoinUrlParams = new GetJoinUrlParameters('desktop-session-token-789'); +$getJoinUrlParams->setSessionName('Mobile Transfer from Desktop'); +$getJoinUrlParams->addMeta('userdata-transfer-initiated', date('Y-m-d H:i:s')); +$getJoinUrlParams->addMeta('userdata-device-platform', 'mobile'); + +$response = $bbb->getJoinUrl($getJoinUrlParams); + +if ($response->success()) { + $joinUrl = $response->getUrl(); + + // Generate QR code (you'll need a QR code library) + // $qrCode = generateQRCode($joinUrl); + + echo "Scan this QR code to transfer your session to mobile device:"; + echo "Join URL: " . $joinUrl; +} else { + echo "Failed to generate transfer URL: " . $response->getMessage(); +} +``` + +### Multi-Screen Setup + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\GetJoinUrlParameters; +use BigBlueButton\Enum\MeetingLayout; + +$bbb = new BigBlueButton(); + +// Original session token +$originalToken = 'main-screen-session-001'; + +// Create second screen with presentation focus +$secondScreenParams = new GetJoinUrlParameters($originalToken); +$secondScreenParams->setSessionName('Second Screen - Presentation View'); +$secondScreenParams->setEnforceLayout(MeetingLayout::PRESENTATION_FOCUS); +$secondScreenParams->addMeta('userdata-screen-role', 'presentation'); + +$secondScreenResponse = $bbb->getJoinUrl($secondScreenParams); + +// Create third screen with participant focus +$thirdScreenParams = new GetJoinUrlParameters($originalToken); +$thirdScreenParams->setSessionName('Third Screen - Participants View'); +$thirdScreenParams->setEnforceLayout(MeetingLayout::PARTICIPANTS_CHAT_ONLY); +$thirdScreenParams->addMeta('userdata-screen-role', 'participants'); + +$thirdScreenResponse = $bbb->getJoinUrl($thirdScreenParams); + +if ($secondScreenResponse->success() && $thirdScreenResponse->success()) { + echo "Second Screen URL: " . $secondScreenResponse->getUrl(); + echo "Third Screen URL: " . $thirdScreenResponse->getUrl(); +} +``` + +## Response Fields + +The GetJoinUrlResponse provides the following fields: + +### Required Fields + +| Field | Type | Description | +|-------|------|-------------| +| `url` | String | The generated join URL | +| `sessionToken` | String | The new session token | +| `userId` | String | The user ID (same as original session) | +| `meetingId` | String | The meeting ID | +| `authToken` | String | Authentication token for the session | +| `guestStatus` | String | Guest status (e.g., "ALLOWED", "DENIED") | +| `userName` | String | The user's name | +| `createdTime` | String | Timestamp when the session was created | + +### Optional Fields + +| Field | Type | Description | +|-------|------|-------------| +| `redirectUrl` | String | Redirect URL if configured | +| `sessionName` | String | The session name if provided | +| `replaceSession` | Boolean | Whether the original session will be replaced | +| `enforceLayout` | String | The enforced layout setting | +| `userData` | Array | Merged userdata parameters | + +## Response Handling + +```php +$response = $bbb->getJoinUrl($getJoinUrlParams); + +if ($response->success()) { + // Basic information + echo "Join URL: " . $response->getUrl(); + echo "Session Token: " . $response->getSessionToken(); + echo "User ID: " . $response->getUserId(); + echo "Meeting ID: " . $response->getMeetingId(); + + // Optional information + if ($response->getSessionName()) { + echo "Session Name: " . $response->getSessionName(); + } + + if ($response->getRedirectUrl()) { + echo "Redirect URL: " . $response->getRedirectUrl(); + } + + // Userdata handling + $userData = $response->getUserData(); + foreach ($userData as $key => $value) { + echo "User Data - {$key}: {$value}"; + } + + // Specific userdata parameter + $deviceType = $response->getUserDataParam('device-type', 'unknown'); + echo "Device Type: " . $deviceType; + +} else { + echo "Error: " . $response->getMessage(); + echo "Status Code: " . $response->getStatusCode(); +} +``` + +## Layout Options + +The `enforceLayout` parameter accepts the same values as the meeting creation: + +```php +use BigBlueButton\Enum\MeetingLayout; + +// Available layout options +MeetingLayout::CUSTOM_LAYOUT +MeetingLayout::SMART_LAYOUT +MeetingLayout::PRESENTATION_FOCUS +MeetingLayout::VIDEO_FOCUS +MeetingLayout::CAMERAS_ONLY +MeetingLayout::PARTICIPANTS_CHAT_ONLY +MeetingLayout::PRESENTATION_ONLY +MeetingLayout::MEDIA_ONLY +``` + +## Userdata Parameters + +Userdata parameters allow you to pass additional information about the session: + +### Common Userdata Parameters + +| Parameter | Example Value | Description | +|-----------|----------------|-------------| +| `userdata-device-type` | `mobile`, `desktop`, `tablet` | Type of device | +| `userdata-screen-role` | `main`, `presentation`, `participants` | Screen purpose in multi-screen setup | +| `userdata-transfer-source` | `desktop`, `mobile`, `web` | Source device for session transfer | +| `userdata-platform` | `iOS`, `Android`, `Windows`, `macOS` | Operating system | +| `userdata-app-version` | `2.1.0` | Application version | + +### Adding Userdata Parameters + +```php +// Single parameter +$getJoinUrlParams->addMeta('userdata-device-type', 'mobile'); + +// Multiple parameters +$getJoinUrlParams->addMeta('userdata-device-type', 'mobile'); +$getJoinUrlParams->addMeta('userdata-platform', 'iOS'); +$getJoinUrlParams->addMeta('userdata-app-version', '2.1.0'); + +// Complex data (JSON encoded) +$deviceInfo = [ + 'type' => 'mobile', + 'os' => 'iOS', + 'version' => '15.0', + 'screen' => [ + 'width' => 375, + 'height' => 667 + ] +]; +$getJoinUrlParams->addMeta('userdata-device-info', json_encode($deviceInfo)); +``` + +## Security Considerations + +### Session Token Security +- Session tokens are sensitive and should be handled securely +- Only share session tokens with authorized users +- Implement proper validation before generating new join URLs + +### Userdata Validation +- Validate userdata parameters on both client and server side +- Sanitize user input to prevent injection attacks +- Consider implementing a blocklist for sensitive userdata parameters + +### Session Replacement +- Use `replaceSession=true` carefully as it immediately invalidates the original session +- Inform users when their original session will be replaced +- Implement proper error handling for session replacement scenarios + +## Error Handling + +Common error scenarios and their handling: + +```php +$response = $bbb->getJoinUrl($getJoinUrlParams); + +if (!$response->success()) { + $message = $response->getMessage(); + $statusCode = $response->getStatusCode(); + + switch ($statusCode) { + case '404': + // Session token not found + echo "Invalid or expired session token"; + break; + + case '403': + // Access denied + echo "Permission denied for session transfer"; + break; + + case '400': + // Bad request + echo "Invalid parameters provided"; + break; + + default: + echo "Unknown error: " . $message; + } +} +``` + +## Best Practices + +1. **Session Naming**: Use descriptive session names to help users identify different sessions +2. **Layout Selection**: Choose appropriate layouts for different device types and use cases +3. **Userdata Organization**: Use consistent naming conventions for userdata parameters +4. **Error Handling**: Implement comprehensive error handling for all scenarios +5. **Security**: Validate and sanitize all input parameters +6. **User Experience**: Provide clear feedback about session transfers and multi-screen setups + +## Use Case Examples + +### Education Scenario +A professor wants to display the main presentation on a projector while managing participants on a tablet: + +```php +// Main screen (projector) - presentation focus +$projectorParams = new GetJoinUrlParameters($professorSessionToken); +$projectorParams->setSessionName('Projector - Presentation View'); +$projectorParams->setEnforceLayout(MeetingLayout::PRESENTATION_FOCUS); + +// Tablet screen - participants management +$tabletParams = new GetJoinUrlParameters($professorSessionToken); +$tabletParams->setSessionName('Tablet - Participants Management'); +$tabletParams->setEnforceLayout(MeetingLayout::PARTICIPANTS_CHAT_ONLY); +``` + +### Corporate Scenario +An executive wants to transfer a meeting from desktop to mobile for commuting: + +```php +$transferParams = new GetJoinUrlParameters($desktopSessionToken); +$transferParams->setReplaceSession(true); +$transferParams->setSessionName('Mobile Transfer - ' . date('H:i')); +$transferParams->addMeta('userdata-transfer-reason', 'commute'); +$transferParams->addMeta('userdata-connection-type', 'mobile'); +``` + +### Support Scenario +A support agent needs to join a customer meeting with elevated permissions: + +```php +$supportParams = new GetJoinUrlParameters($customerSessionToken); +$supportParams->setSessionName('Support Agent Session'); +$supportParams->addMeta('userdata-role', 'support'); +$supportParams->addMeta('userdata-support-id', $supportAgentId); +$supportParams->addMeta('userdata-elevated-permissions', 'true'); +``` + +This API provides powerful flexibility for managing user sessions across different devices and scenarios while maintaining user identity and meeting continuity. diff --git a/docs/src/api_calls/hooks.md b/docs/src/api_calls/hooks.md new file mode 100644 index 00000000..488bb360 --- /dev/null +++ b/docs/src/api_calls/hooks.md @@ -0,0 +1,6 @@ +{{#include ../header.md}} + +# Hooks +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! \ No newline at end of file diff --git a/docs/src/api_calls/meetings.md b/docs/src/api_calls/meetings.md new file mode 100644 index 00000000..05f3a40f --- /dev/null +++ b/docs/src/api_calls/meetings.md @@ -0,0 +1,388 @@ +{{#include ../header.md}} + +# Meetings +In the BigBlueButton-world a video-conference is called a meeting. Once a meeting is created, it is a "ready-to-use" video-conference sitting on the BBB-Server and is waiting for people to join. A BBB-meeting is not something that would be created in advance (e.g. one week prior) in order to distribute a meeting-link inside an invitation to the participants. + +## Administration +### Creating +One of the first steps is the creation of a meeting. A successfully created meeting is the prerequisite to enable participants (moderators and viewers) to join that meeting in a second step. + +#### Default meeting +In order to create a new meeting, you only need to initiate a new object of the `CreateMeetingParameters`-class and pass an identifier (`$meetingId`) and a name (`$meetingName`) to the constructor. This parameter object (`$createMeetingParameters`) must now be passed to the `createMeeting`-function to launch the request to the BBB-Server. This function returns the BBB-server's response (`$createMeetingResponse`). +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\CreateMeetingParameters; + +// create an instance of the BBB-Client (see details in the setup description) +$bbb = new BigBlueButton(); + +// you can choose your own meeting number and title +$meetingId = 123456; +$meetingName = "My first BBB-meeting"; + +// define the required parameters for the meeting +$createMeetingParameters = new CreateMeetingParameters($meetingId, $meetingName); + +// launch the request to the BBB-Server and receive its response +$createMeetingResponse = $bbb->createMeeting($createMeetingParameters); + +if (!$createMeetingResponse->success()) { + throw new \Exception($createMeetingResponse->getMessage()); +} + +// steps once meeting has been created +``` + +#### Customized meeting +To adapt the predefined parameters of a meeting, the parameters for the creation of a meeting must be adapted before sending the creation-request to the BBB-Server. Please check the official API-Reference for all the possible settings. +```php +// ... + +$createMeetingParameters + ->setWelcomeMessage('Dear Student, welcome to our lesson today!') + ->setWebcamsOnlyForModerator('Dear lecture, do not forget to be kind!') + ; + +// ... +``` + +#### Client Settings Override +The BigBlueButton PHP API supports overriding HTML5 client settings from the settings.yml file. This feature allows you to customize the client behavior for specific meetings without modifying the server configuration. + +> [!IMPORTANT] +> For security reasons, the client settings override feature is disabled by default. You must explicitly enable it by setting `allowOverrideClientSettingsOnCreateCall=true`. + +##### Basic Usage +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\CreateMeetingParameters; +use BigBlueButton\Core\ClientSettingsOverride; + +// create an instance of the BBB-Client +$bbb = new BigBlueButton(); + +// define the required parameters for the meeting +$createMeetingParameters = new CreateMeetingParameters($meetingId, $meetingName); + +// enable client settings override +$createMeetingParameters->setAllowOverrideClientSettingsOnCreateCall(true); + +// create client settings override +$clientSettings = new ClientSettingsOverride([ + 'public' => [ + 'kurento' => [ + 'wsUrl' => 'wss://test.bigbluebutton.org/bbb-webrtc-sfu' + ], + 'media' => [ + 'sipjsHackViaWs' => false + ], + 'app' => [ + 'appName' => 'Test Meeting', + 'helpLink' => 'https://www.bigbluebutton.org', + 'autoJoin' => false, + 'askForConfirmationOnLeave' => false, + 'userSettingsStorage' => 'localStorage', + 'defaultSettings' => [ + 'application' => [ + 'overrideLocale' => 'en' + ] + ] + ] + ] +]); + +// set the client settings override +$createMeetingParams->setClientSettingsOverride($clientSettings); + +// launch the request to the BBB-Server +$createMeetingResponse = $bbb->createMeeting($createMeetingParameters); +``` + +##### Advanced Usage with Individual Settings +You can also set individual settings using dot notation: +```php +$clientSettings = new ClientSettingsOverride(); + +// set individual settings +$clientSettings->setSetting('public.app.appName', 'Custom Meeting Name'); +$clientSettings->setSetting('public.kurento.wsUrl', 'wss://custom.example.com/sfu'); +$clientSettings->setSetting('public.media.sipjsHackViaWs', false); + +// get individual settings +$appName = $clientSettings->getSetting('public.app.appName'); +$wsUrl = $clientSettings->getSetting('public.kurento.wsUrl', 'wss://default.example.com'); + +// remove settings +$clientSettings->removeSetting('public.media.sipjsHackViaWs'); + +// set the client settings override +$createMeetingParams->setClientSettingsOverride($clientSettings); +``` + +##### Creating from JSON +You can create a ClientSettingsOverride object from a JSON string: +```php +$jsonSettings = '{ + "public": { + "app": { + "appName": "JSON Meeting", + "helpLink": "https://help.example.com" + } + } +}'; + +$clientSettings = ClientSettingsOverride::fromJson($jsonSettings); +$createMeetingParams->setClientSettingsOverride($clientSettings); +``` + +##### Common Override Settings +Here are some commonly overridden settings: + +**Application Settings:** +- `public.app.appName` - Custom application name +- `public.app.helpLink` - Custom help link +- `public.app.autoJoin` - Auto-join meeting (true/false) +- `public.app.askForConfirmationOnLeave` - Ask for confirmation when leaving +- `public.app.userSettingsStorage` - Storage type for user settings + +**Kurento/WebRTC Settings:** +- `public.kurento.wsUrl` - Custom WebRTC SFU URL +- `public.kurento.turnUrl` - Custom TURN server URL + +**Media Settings:** +- `public.media.sipjsHackViaWs` - SIP.js WebSocket hack +- `public.media.audio.codec` - Preferred audio codec +- `public.media.video.codec` - Preferred video codec + +**Theme Settings:** +- `public.theme.branding.target` - Custom branding target +- `public.theme.custom_css_url` - Custom CSS URL + +> [!NOTE] +> The client settings override takes precedence over server configuration files. Use this feature carefully to avoid unexpected behavior. + +### Insert Document + +Documents can be added either during the creation of a meeting (see `$createMeetingParameters`) or can be added once needed. This section is about adding documents into a running meeting. + +#### old way (presentations) +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Enum\DocumentOption; +use BigBlueButton\Parameters\Config\DocumentOptionsStore; +use BigBlueButton\Parameters\InsertDocumentParameters; + +// create an instance of the BBB-Client (see details in the setup description) +$bbb = new BigBlueButton(); + +// define your variables +$meetingId = 123456; +$url = 'https://your.file.url/example.pdf'; +$file = __DIR__ . '/foldername/example.png'; + +// define the document options +$documentOptions = new DocumentOptionsStore(); +$documentOptions->addAttribute(DocumentOption::CURRENT, true); +$documentOptions->addAttribute(DocumentOption::REMOVABLE, false); +$documentOptions->addAttribute(DocumentOption::DOWNLOADABLE, true); + +// announce 3 documents that shall to be added into the meeting +$insertDocumentParameters = new InsertDocumentParameters($meetingId); +$insertDocumentParameters + ->addPresentation($url) // by a URL (with default document options) + ->addPresentation($url, null, null, $documentOptions) // by a URL and defining the document options + ->addPresentation($url, null, 'new_name.pdf') // by a URL and rename the file + ->addPresentation('filename.pdf', file_get_contents($file)); // by injecting a data stream and define the filename used on BBB-server + +// launch the request to the BBB-Server and receive its response +$insertDocumentResponse = $bbb->insertDocument($insertDocumentParameters); + +if (!$createMeetingResponse->success()) { + throw new \Exception($insertDocumentResponse->getMessage()); +} + +// steps once document has been added +``` +#### new way (documents) +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +```php +``` + +### Joining +Once a meeting is created successfully, it is ready to let the participants into the meeting. This will be done with the join command. It needs to defined into which meeting (`$meetingId`) and by what name (`$name`) the participant shall join the meeting. Additionally the role of the particpant needs to be declared: either as moderator (`Role::MODERATOR`) or as a regular viewer (`Role::VIEWER`). + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\JoinMeetingParameters; +use BigBlueButton\Enum\Role; + +// create an instance of the BBB-Client (see details in the setup description) +$bbb = new BigBlueButton(); + +// define your variables +$meetingID = 123456; +$name = "Peter Parker"; +$role1 = Role::MODERATOR; // choose MODERATOR for a coordinating person +$role2 = Role::VIEWER; // choose VIEWER for normal participants + +// define the required parameters for the user to join the meeting +$joinMeetingParameters = new JoinMeetingParameters($meetingID, $name, $role1); +$joinMeetingParameters->setRedirect(true); // will ensure that the user is redirected to the BBB-Server + +// launch the request to the BBB-Server +$joinMeetingResponse = $bbb->joinMeeting($joinMeetingParameters); + +if (!$joinMeetingResponse->success()) { + throw new \Exception($joinMeetingResponse->getMessage()}); +} + +$url = $joinMeetingResponse->getUrl(); +// ... + +``` +In the example above, the user is redirected directly (`setRedirect(true)`) to the meeting on the BBB-Server. In case the user shall not be redirected (`setRedirect(false)`), the request will provide a URL in its response. This URL can be used to redirect the user later (e.g. by button or link). + +### Ending +A meeting can be ended (destroyed) by calling the `endMeeting`-command. + +```php + +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\EndMeetingParameters; + +// create an instance of the BBB-Client (see details in the setup description) +$bbb = new BigBlueButton(); + +// define your variables +$meetingID = 123456; + +// define the required parameters to end a meeting +$endMeetingParameters = new EndMeetingParameters($meetingID); + +// launch the request to the BBB-Server +$endMeetingResponse = $bbb->endMeeting($endMeetingParameters); + +if (!$endMeetingResponse->success()) { + throw new \Exception($endMeetingResponse->getMessage()}); +} + +// ... +``` + +## Monitoring + +### Is Meeting Running +This command will check if a meeting is currently running. +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\IsMeetingRunningParameters; + +// create an instance of the BBB-Client (see details in the setup description) +$bbb = new BigBlueButton(); + +// define your variables +$meetingID = 123456; + +// define the required parameters for the user to join the meeting +$isMeetingRunningParameters = new IsMeetingRunningParameters($meetingID); + +// launch the request to the BBB-Server +$isMeetingRunningResponse = $bbb->isMeetingRunning($isMeetingRunningParameters); + +if (!$isMeetingRunningResponse->success()) { + throw new \Exception($isMeetingRunningResponse->getMessage()); +} + +if (!$isMeetingRunningResponse->isRunning()) { + // meeting is not running +} else { + // meeting is running +} + +``` +> [!WARNING] +> The BBB-server is understanding as a "running" meeting, where at least one participant has joint. This function deliver `false` if the meeting has been created only and no one has joint yet. + + +### Is Meeting Existing +This command will check if a meeting is existing and just check if a meeting is available (successfully created) on the BBB-Server. In contrast with `isRunning` this command will not check if participants have been joined. + +```php +use BigBlueButton\BigBlueButton; + +// create an instance of the BBB-Client (see details in the setup description) +$bbb = new BigBlueButton(); + +// define your variables +$meetingID = 123456; + +// launch the request to the BBB-Server +$isMeetingExisting = $this->bbb->isMeetingExisting($meetingId); + +if (!$isMeetingExisting) { + // meeting is not existing +} else { + // meeting is existing +} +``` +> [!NOTE] +> This function is a shortcut and runs `getMeetingInfo`-command under the hood. This is why its usage is a bit different compared to other interactions with the BBB-Server (e.g. no Parameter-Object needs to be used) + +### Get Meeting Info +This command will provide a lot of details of a meeting. + +```php +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\GetMeetingInfoParameters; + +// create an instance of the BBB-Client (see details in the setup description) +$bbb = new BigBlueButton(); + +// define your variables +$meetingID = 123456; + +// define the required parameters +$getMeetingInfoParameters = new GetMeetingInfoParameters($meetingID); + +// launch the request to the BBB-Server +$getMeetingInfoResponse = $bbb->getMeetingInfo($getMeetingInfoParameters); + +if (!$getMeetingInfoResponse->success()) { + throw new \Exception($getMeetingInfoResponse->getMessage()); +} + +// get the meeting object +$meeting = $getMeetingInfoResponse->getMeeting(); + +// example of provided information +$meetingName = $meeting->getMeetingName(); +``` + +### Get Meetings +This command will provide a list of the existing meetings in the BBB-Server. + +```php +use BigBlueButton\BigBlueButton; + +// create an instance of the BBB-Client (see details in the setup description) +$bbb = new BigBlueButton(); + +// launch the request to the BBB-Server +$getMeetingsResponse = $bbb->getMeetings(); + +if (!$getMeetingsResponse->success()) { + throw new \Exception($getMeetingsResponse->getMessage()); +} + +// loop over all meetings +foreach ($getMeetingsResponse->getMeetings() as $meeting) { + // treat meeting +} +``` \ No newline at end of file diff --git a/docs/src/api_calls/recordings.md b/docs/src/api_calls/recordings.md new file mode 100644 index 00000000..5dadbee1 --- /dev/null +++ b/docs/src/api_calls/recordings.md @@ -0,0 +1,67 @@ +{{#include ../header.md}} + +# Recordings +## Manage Recordings +### getRecordings +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! +```php + +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\GetRecordingsParameters; + +$recordingParams = new GetRecordingsParameters(); +$bbb = new BigBlueButton(); +$response = $bbb->getRecordings($recordingParams); + +if ($response->getReturnCode() == 'SUCCESS') { + foreach ($response->getRawXml()->recordings->recording as $recording) { + // process all recording + } +} +``` +*note that BigBlueButton need about several minutes to process recording until it available.* +*You can check in* `bbb-record --watch` + +### publishRecordings +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +### updateRecordings +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +### deleteRecordings +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +```php + +use BigBlueButton\BigBlueButton; +use BigBlueButton\Parameters\DeleteRecordingsParameters; + +$bbb = new BigBlueButton(); +$deleteRecordingsParams= new DeleteRecordingsParameters($recordingID); // get from "Get Recordings" +$response = $bbb->deleteRecordings($deleteRecordingsParams); + +if ($response->getReturnCode() == 'SUCCESS') { + // recording deleted +} else { + // something wrong +} +``` + +## Manage Tracks +### getRecordingTextTracks +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +### putRecordingTextTrack +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! \ No newline at end of file diff --git a/docs/src/contributing/contributing.md b/docs/src/contributing/contributing.md new file mode 100644 index 00000000..ec7a1ecb --- /dev/null +++ b/docs/src/contributing/contributing.md @@ -0,0 +1,6 @@ +{{#include ../header.md}} + +# How to Contribute +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! diff --git a/docs/src/contributing/documentation.md b/docs/src/contributing/documentation.md new file mode 100644 index 00000000..fdcab08d --- /dev/null +++ b/docs/src/contributing/documentation.md @@ -0,0 +1,53 @@ +{{#include ../header.md}} + +# Documentation +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +1) Install rust + +2) Install mdbook +``` +cargo install mdbook +``` + + +3) Install this to ensure external links will be opened in a new tab + https://crates.io/crates/mdbook-external-links +``` +cargo install mdbook-external-links +``` + +4) Install extention for alerts + https://crates.io/crates/mdbook-alerts +``` +cargo install mdbook-alerts +``` + +> [!CAUTION] +> ??? How to prevent the markdown below of being parsed? +> +```markdown +> [!NOTE] +> Highlights information that users should take into account, even when skimming. + +> [!TIP] +> Optional information to help a user be more successful. + +> [!IMPORTANT] +> Crucial information necessary for users to succeed. + +> [!WARNING] +> Critical content demanding immediate user attention due to potential risks. + +> [!CAUTION] +> Negative potential consequences of an action. +``` + +![Alerts](https://github.com/lambdalisue/rs-mdbook-alerts/blob/main/example/example.png?raw=true) + +4) build the book locally +``` +mdbook serve --open +``` \ No newline at end of file diff --git a/docs/src/contributing/style_guide.md b/docs/src/contributing/style_guide.md new file mode 100644 index 00000000..3bf2c505 --- /dev/null +++ b/docs/src/contributing/style_guide.md @@ -0,0 +1,6 @@ +{{#include ../header.md}} + +# Style Guide +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! \ No newline at end of file diff --git a/docs/src/contributing/testing.md b/docs/src/contributing/testing.md new file mode 100644 index 00000000..8dc1b2eb --- /dev/null +++ b/docs/src/contributing/testing.md @@ -0,0 +1,6 @@ +{{#include ../header.md}} + +# Testing +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! \ No newline at end of file diff --git a/docs/src/general/getting_started.md b/docs/src/general/getting_started.md new file mode 100644 index 00000000..ec10812f --- /dev/null +++ b/docs/src/general/getting_started.md @@ -0,0 +1,52 @@ +{{#include ../header.md}} + +# Getting Started +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +## Requirements + +- PHP 5.4 or above. +- [curl](https://php.net/manual/book.curl.php) library installed. +- [mbstring](https://php.net/manual/book.mbstring.php) library installed. +- [xml](https://php.net/manual/book.xml.php) library installed. + +BigBlueButton API for PHP is also tested to work with HHVM and fully compatible with PHP 7.0 and above. + +## Installation + +**bigbluebutton-api-php** can be installed via [Composer][composer] CLI + +``` +composer require bigbluebutton/bigbluebutton-api-php:~2.0.0 +``` + +or by editing `composer.json` + +```json +{ + "require": { + "bigbluebutton/bigbluebutton-api-php": "~2.0.0" + } +} +``` + +[composer]: https://getcomposer.org + + +## Configuration +You should have environment variables ```BBB_SECRET``` and ```BBB_SERVER_BASE_URL``` defined in your sever. +\*if you are using Laravel you can add it in your .env + +The you will be able to call BigBlueButton API of your server. A simple usage example for create meeting looks like: + +```php +use BigBlueButton/BigBlueButton; + +$bbb = new BigBlueButton(); +$createMeetingParams = new CreateMeetingParameters('bbb-meeting-uid-65', 'BigBlueButton API Meeting'); +$response = $bbb->createMeeting($createMeetingParams); + +echo "Created Meeting with ID: " . $response->getMeetingId(); +``` \ No newline at end of file diff --git a/docs/src/general/home.md b/docs/src/general/home.md new file mode 100644 index 00000000..b7326719 --- /dev/null +++ b/docs/src/general/home.md @@ -0,0 +1,10 @@ +{{#include ../header.md}} + +# Welcome to the BigBlueButton API PHP +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +In this documentation, we will explain the installation and usage, checking out samples, +setting up different configurations, and advanced settings in our library. This documentation +is specific to library uses only. diff --git a/docs/src/header.md b/docs/src/header.md new file mode 100644 index 00000000..18fb85ed --- /dev/null +++ b/docs/src/header.md @@ -0,0 +1 @@ +![BBB-Logo](../images/header.png) \ No newline at end of file diff --git a/docs/src/images/header.png b/docs/src/images/header.png new file mode 100644 index 00000000..1242ea2f Binary files /dev/null and b/docs/src/images/header.png differ diff --git a/docs/src/other/external_links.md b/docs/src/other/external_links.md new file mode 100644 index 00000000..0ad5029c --- /dev/null +++ b/docs/src/other/external_links.md @@ -0,0 +1,13 @@ +{{#include ../header.md}} + +# External Links +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +- [BigBlueButton Home Page](https://bigbluebutton.org) +- [Documentation](https://docs.bigbluebutton.org) +- [API Reference](https://docs.bigbluebutton.org/development/api/) +- [API Mate](https://bigbluebutton.org/api-mate/) +- [Demo Website](https://demo.bigbluebutton.org) +- [Report issues](https://github.com/bigbluebutton/bigbluebutton-api-php/issues) \ No newline at end of file diff --git a/docs/src/other/faq.md b/docs/src/other/faq.md new file mode 100644 index 00000000..659f3e0a --- /dev/null +++ b/docs/src/other/faq.md @@ -0,0 +1,6 @@ +{{#include ../header.md}} + +# FAQ +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! \ No newline at end of file diff --git a/docs/src/other/full_usage_sample.md b/docs/src/other/full_usage_sample.md new file mode 100644 index 00000000..fdbeb475 --- /dev/null +++ b/docs/src/other/full_usage_sample.md @@ -0,0 +1,282 @@ +{{#include ../header.md}} + +# Full Usage Example +> [!WARNING] +> The content of this section is outdated and is currently under review! +> Please feel invited to contribute! + +## Introduction + +You have been using BigBlueButton for years or you are still discovering it, and you have PHP within your solutions +sphere and considering managing your BigBlueButton meetings with PHP, we are writing this tutorial right for you +and your team. + +BigBlueButton officially offers a PHP library to use for its API. In this tutorial you will learn how to use this PHP +library to create a meeting then join it. + +## Pre-requisites + +Before we can show you how to use the library, it is important to have the following point done: +- BigBlueButton server installed. Easy enough, it takes 15 minutes or less. Just follow this link https://bigbluebutton.org/2018/03/28/install-bigbluebutton-in-15-minutes/ if not already done. +- PHP 7.0 or higher. Whether the library is compatible with previous version of PHP 5.4, 5.5 and 5.6, we highly discourage you to use it on those versions to avoid any unwanted behavior. +- curl, mbstring, simple-xml PHP extensions. They are active by default in most PHP distributions. +- A running HTTP server, Apache2 or nginx. +- Composer PHP dependency manager pre-installed. + +## Installation and configuration + +First, we need to create our composer project. + +``` +composer init โ€“name 'bigbluebutton-join-form' +``` + +Then we need to add the library available on packagist. + +``` +composer require bigbluebutton/bigbluebutton-api-php +``` + +Once we have defined the required dependency, we need to install it using the command below. + +``` +composer install -o --no-dev +``` + +Adding `--no-dev` options, means that we omit development packages that are mainly used to unit test the library. + +The library package has now been downloaded to `vendor` directory in your project root. A configuration final step +is required for the library. + +As you know, the call BigBlueButton API you need the server URL and the shred secret. You can get them from you +BigBlueButton server with 'bbb-conf' http://docs.bigbluebutton.org/install/bbb-conf.html#--secret + +Once you have them, create two environment variables. For Apache2 you can use the `SetEnv` directive or the +`fastcgi_param` for nginx. For Apache2, we advise putting the variables in the `/etc/apache2/envvars` to keep themaway from your source code repository. + +`BBB_SECRET='8cd8ef52e8e101574e400365b55e11a6'` + +`BBB_SERVER_BASE_URL='http://test-install.blindsidenetworks.com/bigbluebutton/'` + +## Set up a basic join meeting form + +Letโ€™s go ahead and create our HTML form to join BigBlueButton meeting. The contact form will contain the following fields: username, a combo-box for the meeting name, a second combo-box for the user role and a checkbox for the client type. + +Your form should look like the image below, and the source code is just below the image. + +![bbbjoinform](https://user-images.githubusercontent.com/4991088/43764586-b2aa24e8-9a25-11e8-826f-06fb393bc298.png) + +```html + + + + + + BigBlueButton Join Meeting - PHP Form + + +

BigBlueButton Join Meeting - PHP Form

+ +
+ +

+ + +

+ +

+ + +

+ +

+ + +

+ +

+ + +

+ +

+ +

+
+ + +``` + +The HTML form is now ready. Letโ€™s see how to handle posted data step by step. All data will be sent then +processed by `join-bbb.php` file. + +## Preparing PHP form processor + +Do you remember we used composer to install the library? Composer creates a file named `autoload.php` inside +`vendor` directory. Just import it to load the necessary classes. + +```php + 'Molecular Chemistry', + 'it' => 'Information Theory', + 'pm' => 'Project Management'); + +$passwords = array('moderator' => 'mPass', + 'attendee' => 'aPass'); +``` + +The PHP API offers an easy way to handle calls. Creating an instance of `BigBlueButton` class without giving any +parameter. After it we are storing the meeting id we got from our form inside the `$meetingId` variable. + +```php +// Init BigBlueButton API +$bbb = new BigBlueButton(); +$meetingId = $HTTP_POST_VARS['meeting']; +``` + +## Creating the meeting + +To create a meeting, only two parameters are mandatory: the meeting ID and the meeting name. For security reasons we +discourage leaving the moderator password and the attendee password empty. For that reason, we are filling them in +the `CreateMeetingParameters` instance. + +```php +// Create the meeting +$createParams = new CreateMeetingParameters($meetingId, $meetings[$meetingId]); +$createParams = $createParams->setModeratorPassword($passwords['moderator']) + ->setAttendeePassword($passwords['attendee']); +$bbb->createMeeting($createParams); +``` + +## Joining the meeting + +A meeting can be joined by two different ways. The first way is to let the BigBlueButton server do the redirection for +you. The second way is to ask for an XML response then construct the URL using `getSessionToken`. Both of the methods +are detailed below. + +Joining the meeting is done in two steps. In the first step we create an instance of `CreateMeetingParameters` and fill +the previously saved `$meetingId`, then `username` and `role` values from POST values. The third required parameter is +password, the role of the user is determined by the system depending on the provided password. For that reason we will +read it from `$passwords` using the `$HTTP_POST_VARS['role']` key. + + +```php +// Send a join meeting request +$joinParams = new JoinMeetingParameters($meetingId, $HTTP_POST_VARS['username'], $passwords[$HTTP_POST_VARS['role']]); +``` + +### Following the server redirection + +We set `redirect` to `true` if we want an immediate redirection to the meeting. We also pass `true` to +`setJoinViaHtml5` to join the meeting using the HTML5 client. + +```php +// Ask for immediate redirection +$joinParams->setRedirect(true) +``` + +Lastly, we ask PHP to follow the join meeting redirection using the `header` function. The redirection will be done by +BigBlueButton by calling `$bbb->getJoinMeetingURL($joinParams))`. You should now see the meeting page. + +```php +// Join the meeting by redirecting the user to the generated URL +header('Status: 301 Moved Permanently', false, 301); +header('Location:' . $bbb->getJoinMeetingURL($joinParams)); +``` + +### Storing join response to join manually + +There is also a different way to join a meeting. To achieve it, we set `redirect` to `false`. + + ```php + // Let the prorgrammer do the redirection later + $joinParams->setRedirect(false) + ``` + +In this particular case the server will return an XML response. To handle it you need to call the `joinMeeting` method. + +```php +$joinResponse = $bbb->joinMeeting($joinParams); +``` + +Then we prepare the server URL for joining the meeting. + +```php +// Prepare the server URL +$bbbServerUrl = "https://my-bbb-server.com"; +``` + +Depending on the client you want to use the join URL construction will be different. + +If you want to join the Flash client, the default URL will look like the lines below. + +```php +// Join the Flash client +header('Status: 301 Moved Permanently', false, 301); +header('Location:' . $bbbServerUrl . "/client/BigBlueButton.html?sessionToken=" . $joinResponse->getSessionToken()); +``` + +If you want to join the meeting using the HTML5 client, the default URL is different. + +```php +// Join the HTML5 client +header('Status: 301 Moved Permanently', false, 301); +header('Location:' . $bbbServerUrl . "/html5client/join?sessionToken=" . $joinResponse->getSessionToken()); +``` + +## Conclusion +You have discovered how to setup a BigBlueButton meeting then join it using the PHP API client library. Go ahead and +explore the library features to implement your own meeting management system for BigBlueButton. diff --git a/docs/theme/book.js b/docs/theme/book.js new file mode 100644 index 00000000..62d7c4cc --- /dev/null +++ b/docs/theme/book.js @@ -0,0 +1,843 @@ +'use strict'; + +/* global default_theme, default_dark_theme, default_light_theme, hljs, ClipboardJS */ + +// Fix back button cache problem +window.onunload = function() { }; + +// Global variable, shared between modules +function playground_text(playground, hidden = true) { + const code_block = playground.querySelector('code'); + + if (window.ace && code_block.classList.contains('editable')) { + const editor = window.ace.edit(code_block); + return editor.getValue(); + } else if (hidden) { + return code_block.textContent; + } else { + return code_block.innerText; + } +} + +(function codeSnippets() { + function fetch_with_timeout(url, options, timeout = 6000) { + return Promise.race([ + fetch(url, options), + new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), timeout)), + ]); + } + + const playgrounds = Array.from(document.querySelectorAll('.playground')); + if (playgrounds.length > 0) { + fetch_with_timeout('https://play.rust-lang.org/meta/crates', { + headers: { + 'Content-Type': 'application/json', + }, + method: 'POST', + mode: 'cors', + }) + .then(response => response.json()) + .then(response => { + // get list of crates available in the rust playground + const playground_crates = response.crates.map(item => item['id']); + playgrounds.forEach(block => handle_crate_list_update(block, playground_crates)); + }); + } + + function handle_crate_list_update(playground_block, playground_crates) { + // update the play buttons after receiving the response + update_play_button(playground_block, playground_crates); + + // and install on change listener to dynamically update ACE editors + if (window.ace) { + const code_block = playground_block.querySelector('code'); + if (code_block.classList.contains('editable')) { + const editor = window.ace.edit(code_block); + editor.addEventListener('change', () => { + update_play_button(playground_block, playground_crates); + }); + // add Ctrl-Enter command to execute rust code + editor.commands.addCommand({ + name: 'run', + bindKey: { + win: 'Ctrl-Enter', + mac: 'Ctrl-Enter', + }, + exec: _editor => run_rust_code(playground_block), + }); + } + } + } + + // updates the visibility of play button based on `no_run` class and + // used crates vs ones available on https://play.rust-lang.org + function update_play_button(pre_block, playground_crates) { + const play_button = pre_block.querySelector('.play-button'); + + // skip if code is `no_run` + if (pre_block.querySelector('code').classList.contains('no_run')) { + play_button.classList.add('hidden'); + return; + } + + // get list of `extern crate`'s from snippet + const txt = playground_text(pre_block); + const re = /extern\s+crate\s+([a-zA-Z_0-9]+)\s*;/g; + const snippet_crates = []; + let item; + while (item = re.exec(txt)) { + snippet_crates.push(item[1]); + } + + // check if all used crates are available on play.rust-lang.org + const all_available = snippet_crates.every(function(elem) { + return playground_crates.indexOf(elem) > -1; + }); + + if (all_available) { + play_button.classList.remove('hidden'); + play_button.hidden = false; + } else { + play_button.classList.add('hidden'); + } + } + + function run_rust_code(code_block) { + let result_block = code_block.querySelector('.result'); + if (!result_block) { + result_block = document.createElement('code'); + result_block.className = 'result hljs language-bash'; + + code_block.append(result_block); + } + + const text = playground_text(code_block); + const classes = code_block.querySelector('code').classList; + let edition = '2015'; + classes.forEach(className => { + if (className.startsWith('edition')) { + edition = className.slice(7); + } + }); + const params = { + version: 'stable', + optimize: '0', + code: text, + edition: edition, + }; + + if (text.indexOf('#![feature') !== -1) { + params.version = 'nightly'; + } + + result_block.innerText = 'Running...'; + + fetch_with_timeout('https://play.rust-lang.org/evaluate.json', { + headers: { + 'Content-Type': 'application/json', + }, + method: 'POST', + mode: 'cors', + body: JSON.stringify(params), + }) + .then(response => response.json()) + .then(response => { + if (response.result.trim() === '') { + result_block.innerText = 'No output'; + result_block.classList.add('result-no-output'); + } else { + result_block.innerText = response.result; + result_block.classList.remove('result-no-output'); + } + }) + .catch(error => result_block.innerText = 'Playground Communication: ' + error.message); + } + + // Syntax highlighting Configuration + hljs.configure({ + tabReplace: ' ', // 4 spaces + languages: [], // Languages used for auto-detection + }); + + const code_nodes = Array + .from(document.querySelectorAll('code')) + // Don't highlight `inline code` blocks in headers. + .filter(function(node) { + return !node.parentElement.classList.contains('header'); + }); + + if (window.ace) { + // language-rust class needs to be removed for editable + // blocks or highlightjs will capture events + code_nodes + .filter(function(node) { + return node.classList.contains('editable'); + }) + .forEach(function(block) { + block.classList.remove('language-rust'); + }); + + code_nodes + .filter(function(node) { + return !node.classList.contains('editable'); + }) + .forEach(function(block) { + hljs.highlightBlock(block); + }); + } else { + code_nodes.forEach(function(block) { + hljs.highlightBlock(block); + }); + } + + // Adding the hljs class gives code blocks the color css + // even if highlighting doesn't apply + code_nodes.forEach(function(block) { + block.classList.add('hljs'); + }); + + Array.from(document.querySelectorAll('code.hljs')).forEach(function(block) { + + const lines = Array.from(block.querySelectorAll('.boring')); + // If no lines were hidden, return + if (!lines.length) { + return; + } + block.classList.add('hide-boring'); + + const buttons = document.createElement('div'); + buttons.className = 'buttons'; + buttons.innerHTML = ''; + buttons.firstChild.innerHTML = document.getElementById('fa-eye').innerHTML; + + // add expand button + const pre_block = block.parentNode; + pre_block.insertBefore(buttons, pre_block.firstChild); + + buttons.firstChild.addEventListener('click', function(e) { + if (this.title === 'Show hidden lines') { + this.innerHTML = document.getElementById('fa-eye-slash').innerHTML; + this.title = 'Hide lines'; + this.setAttribute('aria-label', e.target.title); + + block.classList.remove('hide-boring'); + } else if (this.title === 'Hide lines') { + this.innerHTML = document.getElementById('fa-eye').innerHTML; + this.title = 'Show hidden lines'; + this.setAttribute('aria-label', e.target.title); + + block.classList.add('hide-boring'); + } + }); + }); + + if (window.playground_copyable) { + Array.from(document.querySelectorAll('pre code')).forEach(function(block) { + const pre_block = block.parentNode; + if (!pre_block.classList.contains('playground')) { + let buttons = pre_block.querySelector('.buttons'); + if (!buttons) { + buttons = document.createElement('div'); + buttons.className = 'buttons'; + pre_block.insertBefore(buttons, pre_block.firstChild); + } + + const clipButton = document.createElement('button'); + clipButton.className = 'clip-button'; + clipButton.title = 'Copy to clipboard'; + clipButton.setAttribute('aria-label', clipButton.title); + clipButton.innerHTML = ''; + + buttons.insertBefore(clipButton, buttons.firstChild); + } + }); + } + + // Process playground code blocks + Array.from(document.querySelectorAll('.playground')).forEach(function(pre_block) { + // Add play button + let buttons = pre_block.querySelector('.buttons'); + if (!buttons) { + buttons = document.createElement('div'); + buttons.className = 'buttons'; + pre_block.insertBefore(buttons, pre_block.firstChild); + } + + const runCodeButton = document.createElement('button'); + runCodeButton.className = 'play-button'; + runCodeButton.hidden = true; + runCodeButton.title = 'Run this code'; + runCodeButton.setAttribute('aria-label', runCodeButton.title); + runCodeButton.innerHTML = document.getElementById('fa-play').innerHTML; + + buttons.insertBefore(runCodeButton, buttons.firstChild); + runCodeButton.addEventListener('click', () => { + run_rust_code(pre_block); + }); + + if (window.playground_copyable) { + const copyCodeClipboardButton = document.createElement('button'); + copyCodeClipboardButton.className = 'clip-button'; + copyCodeClipboardButton.innerHTML = ''; + copyCodeClipboardButton.title = 'Copy to clipboard'; + copyCodeClipboardButton.setAttribute('aria-label', copyCodeClipboardButton.title); + + buttons.insertBefore(copyCodeClipboardButton, buttons.firstChild); + } + + const code_block = pre_block.querySelector('code'); + if (window.ace && code_block.classList.contains('editable')) { + const undoChangesButton = document.createElement('button'); + undoChangesButton.className = 'reset-button'; + undoChangesButton.title = 'Undo changes'; + undoChangesButton.setAttribute('aria-label', undoChangesButton.title); + undoChangesButton.innerHTML += + document.getElementById('fa-clock-rotate-left').innerHTML; + + buttons.insertBefore(undoChangesButton, buttons.firstChild); + + undoChangesButton.addEventListener('click', function() { + const editor = window.ace.edit(code_block); + editor.setValue(editor.originalCode); + editor.clearSelection(); + }); + } + }); +})(); + +(function themes() { + const html = document.querySelector('html'); + const themeToggleButton = document.getElementById('mdbook-theme-toggle'); + const themePopup = document.getElementById('mdbook-theme-list'); + const themeColorMetaTag = document.querySelector('meta[name="theme-color"]'); + const themeIds = []; + themePopup.querySelectorAll('button.theme').forEach(function(el) { + themeIds.push(el.id); + }); + const stylesheets = { + ayuHighlight: document.querySelector('#mdbook-ayu-highlight-css'), + tomorrowNight: document.querySelector('#mdbook-tomorrow-night-css'), + highlight: document.querySelector('#mdbook-highlight-css'), + }; + + function showThemes() { + themePopup.style.display = 'block'; + themeToggleButton.setAttribute('aria-expanded', true); + themePopup.querySelector('button#mdbook-theme-' + get_theme()).focus(); + } + + function updateThemeSelected() { + themePopup.querySelectorAll('.theme-selected').forEach(function(el) { + el.classList.remove('theme-selected'); + }); + const selected = get_saved_theme() ?? 'default_theme'; + let element = themePopup.querySelector('button#mdbook-theme-' + selected); + if (element === null) { + // Fall back in case there is no "Default" item. + element = themePopup.querySelector('button#mdbook-theme-' + get_theme()); + } + element.classList.add('theme-selected'); + } + + function hideThemes() { + themePopup.style.display = 'none'; + themeToggleButton.setAttribute('aria-expanded', false); + themeToggleButton.focus(); + } + + function get_saved_theme() { + let theme = null; + try { + theme = localStorage.getItem('mdbook-theme'); + } catch { + // ignore error. + } + return theme; + } + + function delete_saved_theme() { + localStorage.removeItem('mdbook-theme'); + } + + function get_theme() { + const theme = get_saved_theme(); + if (theme === null || theme === undefined || !themeIds.includes('mdbook-theme-' + theme)) { + if (typeof default_dark_theme === 'undefined') { + // A customized index.hbs might not define this, so fall back to + // old behavior of determining the default on page load. + return default_theme; + } + return window.matchMedia('(prefers-color-scheme: dark)').matches + ? default_dark_theme + : default_light_theme; + } else { + return theme; + } + } + + let previousTheme = default_theme; + function set_theme(theme, store = true) { + let ace_theme; + + if (theme === 'coal' || theme === 'navy') { + stylesheets.ayuHighlight.disabled = true; + stylesheets.tomorrowNight.disabled = false; + stylesheets.highlight.disabled = true; + + ace_theme = 'ace/theme/tomorrow_night'; + } else if (theme === 'ayu') { + stylesheets.ayuHighlight.disabled = false; + stylesheets.tomorrowNight.disabled = true; + stylesheets.highlight.disabled = true; + ace_theme = 'ace/theme/tomorrow_night'; + } else { + stylesheets.ayuHighlight.disabled = true; + stylesheets.tomorrowNight.disabled = true; + stylesheets.highlight.disabled = false; + ace_theme = 'ace/theme/dawn'; + } + + setTimeout(function() { + themeColorMetaTag.content = getComputedStyle(document.documentElement).backgroundColor; + }, 1); + + if (window.ace && window.editors) { + window.editors.forEach(function(editor) { + editor.setTheme(ace_theme); + }); + } + + if (store) { + try { + localStorage.setItem('mdbook-theme', theme); + } catch { + // ignore error. + } + } + + html.classList.remove(previousTheme); + html.classList.add(theme); + previousTheme = theme; + updateThemeSelected(); + } + + const query = window.matchMedia('(prefers-color-scheme: dark)'); + query.onchange = function() { + set_theme(get_theme(), false); + }; + + // Set theme. + set_theme(get_theme(), false); + + themeToggleButton.addEventListener('click', function() { + if (themePopup.style.display === 'block') { + hideThemes(); + } else { + showThemes(); + } + }); + + themePopup.addEventListener('click', function(e) { + let theme; + if (e.target.className === 'theme') { + theme = e.target.id; + } else if (e.target.parentElement.className === 'theme') { + theme = e.target.parentElement.id; + } else { + return; + } + theme = theme.replace(/^mdbook-theme-/, ''); + + if (theme === 'default_theme' || theme === null) { + delete_saved_theme(); + set_theme(get_theme(), false); + } else { + set_theme(theme); + } + }); + + themePopup.addEventListener('focusout', function(e) { + // e.relatedTarget is null in Safari and Firefox on macOS (see workaround below) + if (!!e.relatedTarget && + !themeToggleButton.contains(e.relatedTarget) && + !themePopup.contains(e.relatedTarget) + ) { + hideThemes(); + } + }); + + // Should not be needed, but it works around an issue on macOS & iOS: + // https://github.com/rust-lang/mdBook/issues/628 + document.addEventListener('click', function(e) { + if (themePopup.style.display === 'block' && + !themeToggleButton.contains(e.target) && + !themePopup.contains(e.target) + ) { + hideThemes(); + } + }); + + document.addEventListener('keydown', function(e) { + if (e.altKey || e.ctrlKey || e.metaKey || e.shiftKey) { + return; + } + if (!themePopup.contains(e.target)) { + return; + } + + let li; + switch (e.key) { + case 'Escape': + e.preventDefault(); + hideThemes(); + break; + case 'ArrowUp': + e.preventDefault(); + li = document.activeElement.parentElement; + if (li && li.previousElementSibling) { + li.previousElementSibling.querySelector('button').focus(); + } + break; + case 'ArrowDown': + e.preventDefault(); + li = document.activeElement.parentElement; + if (li && li.nextElementSibling) { + li.nextElementSibling.querySelector('button').focus(); + } + break; + case 'Home': + e.preventDefault(); + themePopup.querySelector('li:first-child button').focus(); + break; + case 'End': + e.preventDefault(); + themePopup.querySelector('li:last-child button').focus(); + break; + } + }); +})(); + +(function sidebar() { + const sidebar = document.getElementById('mdbook-sidebar'); + const sidebarLinks = document.querySelectorAll('#mdbook-sidebar a'); + const sidebarToggleButton = document.getElementById('mdbook-sidebar-toggle'); + const sidebarResizeHandle = document.getElementById('mdbook-sidebar-resize-handle'); + const sidebarCheckbox = document.getElementById('mdbook-sidebar-toggle-anchor'); + let firstContact = null; + + + /* Because we cannot change the `display` using only CSS after/before the transition, we + need JS to do it. We change the display to prevent the browsers search to find text inside + the collapsed sidebar. */ + if (!document.documentElement.classList.contains('sidebar-visible')) { + sidebar.style.display = 'none'; + } + sidebar.addEventListener('transitionend', () => { + /* We only change the display to "none" if we're collapsing the sidebar. */ + if (!sidebarCheckbox.checked) { + sidebar.style.display = 'none'; + } + }); + sidebarToggleButton.addEventListener('click', () => { + /* To allow the sidebar expansion animation, we first need to put back the display. */ + if (!sidebarCheckbox.checked) { + sidebar.style.display = ''; + // Workaround for Safari skipping the animation when changing + // `display` and a transform in the same event loop. This forces a + // reflow after updating the display. + sidebar.offsetHeight; + } + }); + + function showSidebar() { + document.documentElement.classList.add('sidebar-visible'); + Array.from(sidebarLinks).forEach(function(link) { + link.setAttribute('tabIndex', 0); + }); + sidebarToggleButton.setAttribute('aria-expanded', true); + sidebar.setAttribute('aria-hidden', false); + try { + localStorage.setItem('mdbook-sidebar', 'visible'); + } catch { + // Ignore error. + } + } + + function hideSidebar() { + document.documentElement.classList.remove('sidebar-visible'); + Array.from(sidebarLinks).forEach(function(link) { + link.setAttribute('tabIndex', -1); + }); + sidebarToggleButton.setAttribute('aria-expanded', false); + sidebar.setAttribute('aria-hidden', true); + try { + localStorage.setItem('mdbook-sidebar', 'hidden'); + } catch { + // Ignore error. + } + } + + // Toggle sidebar + sidebarCheckbox.addEventListener('change', function sidebarToggle() { + if (sidebarCheckbox.checked) { + const current_width = parseInt( + document.documentElement.style.getPropertyValue('--sidebar-target-width'), 10); + if (current_width < 150) { + document.documentElement.style.setProperty('--sidebar-target-width', '150px'); + } + showSidebar(); + } else { + hideSidebar(); + } + }); + + sidebarResizeHandle.addEventListener('mousedown', initResize, false); + + function initResize() { + window.addEventListener('mousemove', resize, false); + window.addEventListener('mouseup', stopResize, false); + document.documentElement.classList.add('sidebar-resizing'); + } + function resize(e) { + let pos = e.clientX - sidebar.offsetLeft; + if (pos < 20) { + hideSidebar(); + } else { + if (!document.documentElement.classList.contains('sidebar-visible')) { + showSidebar(); + } + pos = Math.min(pos, window.innerWidth - 100); + document.documentElement.style.setProperty('--sidebar-target-width', pos + 'px'); + } + } + //on mouseup remove windows functions mousemove & mouseup + function stopResize() { + document.documentElement.classList.remove('sidebar-resizing'); + window.removeEventListener('mousemove', resize, false); + window.removeEventListener('mouseup', stopResize, false); + } + + document.addEventListener('touchstart', function(e) { + firstContact = { + x: e.touches[0].clientX, + time: Date.now(), + }; + }, { passive: true }); + + document.addEventListener('touchmove', function(e) { + if (!firstContact) { + return; + } + + const curX = e.touches[0].clientX; + const xDiff = curX - firstContact.x, + tDiff = Date.now() - firstContact.time; + + if (tDiff < 250 && Math.abs(xDiff) >= 150) { + if (xDiff >= 0 && firstContact.x < Math.min(document.body.clientWidth * 0.25, 300)) { + showSidebar(); + } else if (xDiff < 0 && curX < 300) { + hideSidebar(); + } + + firstContact = null; + } + }, { passive: true }); +})(); + +(function chapterNavigation() { + document.addEventListener('keydown', function(e) { + if (e.altKey || e.ctrlKey || e.metaKey) { + return; + } + if (window.search && window.search.hasFocus()) { + return; + } + const html = document.querySelector('html'); + + function next() { + const nextButton = document.querySelector('.nav-chapters.next'); + if (nextButton) { + window.location.href = nextButton.href; + } + } + function prev() { + const previousButton = document.querySelector('.nav-chapters.previous'); + if (previousButton) { + window.location.href = previousButton.href; + } + } + function showHelp() { + const container = document.getElementById('mdbook-help-container'); + const overlay = document.getElementById('mdbook-help-popup'); + container.style.display = 'flex'; + + // Clicking outside the popup will dismiss it. + const mouseHandler = event => { + if (overlay.contains(event.target)) { + return; + } + if (event.button !== 0) { + return; + } + event.preventDefault(); + event.stopPropagation(); + document.removeEventListener('mousedown', mouseHandler); + hideHelp(); + }; + + // Pressing esc will dismiss the popup. + const escapeKeyHandler = event => { + if (event.key === 'Escape') { + event.preventDefault(); + event.stopPropagation(); + document.removeEventListener('keydown', escapeKeyHandler, true); + hideHelp(); + } + }; + document.addEventListener('keydown', escapeKeyHandler, true); + document.getElementById('mdbook-help-container') + .addEventListener('mousedown', mouseHandler); + } + function hideHelp() { + document.getElementById('mdbook-help-container').style.display = 'none'; + } + + // Usually needs the Shift key to be pressed + switch (e.key) { + case '?': + e.preventDefault(); + showHelp(); + break; + } + + // Rest of the keys are only active when the Shift key is not pressed + if (e.shiftKey) { + return; + } + + switch (e.key) { + case 'ArrowRight': + e.preventDefault(); + if (html.dir === 'rtl') { + prev(); + } else { + next(); + } + break; + case 'ArrowLeft': + e.preventDefault(); + if (html.dir === 'rtl') { + next(); + } else { + prev(); + } + break; + } + }); +})(); + +(function clipboard() { + const clipButtons = document.querySelectorAll('.clip-button'); + + function hideTooltip(elem) { + elem.firstChild.innerText = ''; + elem.className = 'clip-button'; + } + + function showTooltip(elem, msg) { + elem.firstChild.innerText = msg; + elem.className = 'clip-button tooltipped'; + } + + const clipboardSnippets = new ClipboardJS('.clip-button', { + text: function(trigger) { + hideTooltip(trigger); + const playground = trigger.closest('pre'); + return playground_text(playground, false); + }, + }); + + Array.from(clipButtons).forEach(function(clipButton) { + clipButton.addEventListener('mouseout', function(e) { + hideTooltip(e.currentTarget); + }); + }); + + clipboardSnippets.on('success', function(e) { + e.clearSelection(); + showTooltip(e.trigger, 'Copied!'); + }); + + clipboardSnippets.on('error', function(e) { + showTooltip(e.trigger, 'Clipboard error!'); + }); +})(); + +(function scrollToTop() { + const menuTitle = document.querySelector('.menu-title'); + + menuTitle.addEventListener('click', function() { + document.scrollingElement.scrollTo({ top: 0, behavior: 'smooth' }); + }); +})(); + +(function controllMenu() { + const menu = document.getElementById('mdbook-menu-bar'); + + (function controllPosition() { + let scrollTop = document.scrollingElement.scrollTop; + let prevScrollTop = scrollTop; + const minMenuY = -menu.clientHeight - 50; + // When the script loads, the page can be at any scroll (e.g. if you refresh it). + menu.style.top = scrollTop + 'px'; + // Same as parseInt(menu.style.top.slice(0, -2), but faster + let topCache = menu.style.top.slice(0, -2); + menu.classList.remove('sticky'); + let stickyCache = false; // Same as menu.classList.contains('sticky'), but faster + document.addEventListener('scroll', function() { + scrollTop = Math.max(document.scrollingElement.scrollTop, 0); + // `null` means that it doesn't need to be updated + let nextSticky = null; + let nextTop = null; + const scrollDown = scrollTop > prevScrollTop; + const menuPosAbsoluteY = topCache - scrollTop; + if (scrollDown) { + nextSticky = false; + if (menuPosAbsoluteY > 0) { + nextTop = prevScrollTop; + } + } else { + if (menuPosAbsoluteY > 0) { + nextSticky = true; + } else if (menuPosAbsoluteY < minMenuY) { + nextTop = prevScrollTop + minMenuY; + } + } + if (nextSticky === true && stickyCache === false) { + menu.classList.add('sticky'); + stickyCache = true; + } else if (nextSticky === false && stickyCache === true) { + menu.classList.remove('sticky'); + stickyCache = false; + } + if (nextTop !== null) { + menu.style.top = nextTop + 'px'; + topCache = nextTop; + } + prevScrollTop = scrollTop; + }, { passive: true }); + })(); + (function controllBorder() { + function updateBorder() { + if (menu.offsetTop === 0) { + menu.classList.remove('bordered'); + } else { + menu.classList.add('bordered'); + } + } + updateBorder(); + document.addEventListener('scroll', updateBorder, { passive: true }); + })(); +})(); diff --git a/docs/theme/css/bbb.css b/docs/theme/css/bbb.css new file mode 100644 index 00000000..e5fe214f --- /dev/null +++ b/docs/theme/css/bbb.css @@ -0,0 +1,32 @@ +.nav-wide-wrapper { + display: none; +} + +main h2 a:before { + content: counter(h2counter) ".\0000a0"; +} +main h3 a:before { + content: counter(h2counter) "." counter(h3counter) ".\0000a0"; +} +main h4 a:before { + content: counter(h2counter) "." counter(h3counter) "." counter(h4counter) ".\0000a0"; +} + +main h1 { + counter-reset: h2counter; + border-bottom: 3px solid coral +} + +main h2 { + counter-reset: h3counter; + counter-increment: h2counter; +} + +main h3 { + counter-reset: h4counter; + counter-increment: h3counter; +} + +main h4 { + counter-increment: h4counter; +} \ No newline at end of file diff --git a/docs/theme/css/chrome.css b/docs/theme/css/chrome.css new file mode 100644 index 00000000..bab38894 --- /dev/null +++ b/docs/theme/css/chrome.css @@ -0,0 +1,756 @@ +/* CSS for UI elements (a.k.a. chrome) */ + +html { + scrollbar-color: var(--scrollbar) transparent; +} +#mdbook-searchresults a, +.content a:link, +a:visited, +a > .hljs { + color: var(--links); +} + +/* + mdbook-body-container is necessary because mobile browsers don't seem to like + overflow-x on the body tag when there is a tag. +*/ +#mdbook-body-container { + /* + This is used when the sidebar pushes the body content off the side of + the screen on small screens. Without it, dragging on mobile Safari + will want to reposition the viewport in a weird way. + */ + overflow-x: clip; +} + +/* Menu Bar */ + +#mdbook-menu-bar, +#mdbook-menu-bar-hover-placeholder { + z-index: 101; + margin: auto calc(0px - var(--page-padding)); +} +#mdbook-menu-bar { + position: relative; + display: flex; + flex-wrap: wrap; + background-color: var(--bg); + border-block-end-color: var(--bg); + border-block-end-width: 1px; + border-block-end-style: solid; +} +#mdbook-menu-bar.sticky, +#mdbook-menu-bar-hover-placeholder:hover + #mdbook-menu-bar, +#mdbook-menu-bar:hover, +html.sidebar-visible #mdbook-menu-bar { + position: -webkit-sticky; + position: sticky; + top: 0 !important; +} +#mdbook-menu-bar-hover-placeholder { + position: sticky; + position: -webkit-sticky; + top: 0; + height: var(--menu-bar-height); +} +#mdbook-menu-bar.bordered { + border-block-end-color: var(--table-border-color); +} +#mdbook-menu-bar .fa-svg, #mdbook-menu-bar .icon-button { + position: relative; + padding: 0 8px; + z-index: 10; + line-height: var(--menu-bar-height); + cursor: pointer; + transition: color 0.5s; +} +@media only screen and (max-width: 420px) { + #mdbook-menu-bar .fa-svg, #mdbook-menu-bar .icon-button { + padding: 0 5px; + } +} + +.icon-button { + border: none; + background: none; + padding: 0; + color: inherit; +} +.icon-button .fa-svg { + margin: 0; +} + +.right-buttons { + margin: 0 15px; +} +.right-buttons a { + text-decoration: none; +} + +.left-buttons { + display: flex; + margin: 0 5px; +} +html:not(.js) .left-buttons button { + display: none; +} + +.menu-title { + display: inline-block; + font-weight: 200; + font-size: 2.4rem; + line-height: var(--menu-bar-height); + text-align: center; + margin: 0; + flex: 1; + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} +.menu-title { + cursor: pointer; +} + +.menu-bar, +.menu-bar:visited, +.nav-chapters, +.nav-chapters:visited, +.mobile-nav-chapters, +.mobile-nav-chapters:visited, +.menu-bar .icon-button, +.menu-bar a .fa-svg { + color: var(--icons); +} + +.menu-bar .fa-svg:hover, +.menu-bar .icon-button:hover, +.nav-chapters:hover, +.mobile-nav-chapters .fa-svg:hover { + color: var(--icons-hover); +} + +/* Nav Icons */ + +.nav-chapters { + font-size: 2.5em; + text-align: center; + text-decoration: none; + + position: fixed; + top: 0; + bottom: 0; + margin: 0; + max-width: 150px; + min-width: 90px; + + display: flex; + justify-content: center; + align-content: center; + flex-direction: column; + + transition: color 0.5s, background-color 0.5s; +} + +.nav-chapters:hover { + text-decoration: none; + background-color: var(--theme-hover); + transition: background-color 0.15s, color 0.15s; +} + +.nav-wrapper { + margin-block-start: 50px; + display: none; +} + +.mobile-nav-chapters { + font-size: 2.5em; + text-align: center; + text-decoration: none; + width: 90px; + border-radius: 5px; + background-color: var(--sidebar-bg); +} + +/* Only Firefox supports flow-relative values */ +.previous { float: left; } +[dir=rtl] .previous { float: right; } + +/* Only Firefox supports flow-relative values */ +.next { + float: right; + right: var(--page-padding); +} +[dir=rtl] .next { + float: left; + right: unset; + left: var(--page-padding); +} + +@media only screen and (max-width: 1080px) { + .nav-wide-wrapper { display: none; } + .nav-wrapper { display: block; } +} + +/* sidebar-visible */ +@media only screen and (max-width: 1380px) { + #mdbook-sidebar-toggle-anchor:checked ~ .page-wrapper .nav-wide-wrapper { display: none; } + #mdbook-sidebar-toggle-anchor:checked ~ .page-wrapper .nav-wrapper { display: block; } +} + +/* Inline code */ + +:not(pre) > .hljs { + display: inline; + padding: 0.1em 0.3em; + border-radius: 3px; +} + +:not(pre):not(a) > .hljs { + color: var(--inline-code-color); + overflow-x: initial; +} + +a:hover > .hljs { + text-decoration: underline; +} + +pre { + position: relative; +} +pre > .buttons { + position: absolute; + z-index: 100; + right: 0px; + top: 2px; + margin: 0px; + padding: 2px 0px; + + color: var(--sidebar-fg); + cursor: pointer; + visibility: hidden; + opacity: 0; + transition: visibility 0.1s linear, opacity 0.1s linear; +} +pre:hover > .buttons { + visibility: visible; + opacity: 1 +} +pre > .buttons :hover { + color: var(--sidebar-active); + border-color: var(--icons-hover); + background-color: var(--theme-hover); +} +pre > .buttons button { + cursor: inherit; + margin: 0px 5px; + padding: 2px 3px 0px 4px; + font-size: 23px; + + border-style: solid; + border-width: 1px; + border-radius: 4px; + border-color: var(--icons); + background-color: var(--theme-popup-bg); + transition: 100ms; + transition-property: color,border-color,background-color; + color: var(--icons); +} + +pre > .buttons button.clip-button { + padding: 2px 4px 0px 6px; +} +pre > .buttons button.clip-button::before { + /* clipboard image from octicons (https://github.com/primer/octicons/tree/v2.0.0) MIT license + */ + content: url('data:image/svg+xml,\ +\ +\ +'); + filter: var(--copy-button-filter); +} +pre > .buttons button.clip-button:hover::before { + filter: var(--copy-button-filter-hover); +} + +@media (pointer: coarse) { + pre > .buttons button { + /* On mobile, make it easier to tap buttons. */ + padding: 0.3rem 1rem; + } + + .sidebar-resize-indicator { + /* Hide resize indicator on devices with limited accuracy */ + display: none; + } +} +pre > code { + display: block; + padding: 1rem; +} + +/* FIXME: ACE editors overlap their buttons because ACE does absolute + positioning within the code block which breaks padding. The only solution I + can think of is to move the padding to the outer pre tag (or insert a div + wrapper), but that would require fixing a whole bunch of CSS rules. +*/ +.hljs.ace_editor { + padding: 0rem 0rem; +} + +pre > .result { + margin-block-start: 10px; +} + +/* Search */ + +#mdbook-searchresults a { + text-decoration: none; +} + +mark { + border-radius: 2px; + padding-block-start: 0; + padding-block-end: 1px; + padding-inline-start: 3px; + padding-inline-end: 3px; + margin-block-start: 0; + margin-block-end: -1px; + margin-inline-start: -3px; + margin-inline-end: -3px; + background-color: var(--search-mark-bg); + transition: background-color 300ms linear; + cursor: pointer; +} + +mark.fade-out { + background-color: rgba(0,0,0,0) !important; + cursor: auto; +} + +.searchbar-outer { + margin-inline-start: auto; + margin-inline-end: auto; + max-width: var(--content-max-width); +} + +#mdbook-searchbar-outer.searching #mdbook-searchbar { + padding-right: 30px; +} +#mdbook-searchbar-outer .spinner-wrapper { + display: none; +} +#mdbook-searchbar-outer.searching .spinner-wrapper { + display: block; +} + +.search-wrapper { + position: relative; +} + +.spinner-wrapper { + --spinner-margin: 2px; + position: absolute; + margin-block-start: calc(var(--searchbar-margin-block-start) + var(--spinner-margin)); + right: var(--spinner-margin); + top: 0; + bottom: var(--spinner-margin); + padding: 6px; + background-color: var(--bg); +} + +#fa-spin { + animation: rotating 2s linear infinite; + display: inline-block; +} + +@keyframes rotating { + from { + transform: rotate(0deg); + } + to { + transform: rotate(360deg); + } +} + +#mdbook-searchbar { + width: 100%; + margin-block-start: var(--searchbar-margin-block-start); + margin-block-end: 0; + margin-inline-start: auto; + margin-inline-end: auto; + padding: 10px 16px; + transition: box-shadow 300ms ease-in-out; + border: 1px solid var(--searchbar-border-color); + border-radius: 3px; + background-color: var(--searchbar-bg); + color: var(--searchbar-fg); +} +#mdbook-searchbar:focus, +#mdbook-searchbar.active { + box-shadow: 0 0 3px var(--searchbar-shadow-color); +} + +.searchresults-header { + font-weight: bold; + font-size: 1em; + padding-block-start: 18px; + padding-block-end: 0; + padding-inline-start: 5px; + padding-inline-end: 0; + color: var(--searchresults-header-fg); +} + +.searchresults-outer { + margin-inline-start: auto; + margin-inline-end: auto; + max-width: var(--content-max-width); + border-block-end: 1px dashed var(--searchresults-border-color); +} + +ul#mdbook-searchresults { + list-style: none; + padding-inline-start: 20px; +} +ul#mdbook-searchresults li { + margin: 10px 0px; + padding: 2px; + border-radius: 2px; +} +ul#mdbook-searchresults li.focus { + background-color: var(--searchresults-li-bg); +} +ul#mdbook-searchresults span.teaser { + display: block; + clear: both; + margin-block-start: 5px; + margin-block-end: 0; + margin-inline-start: 20px; + margin-inline-end: 0; + font-size: 0.8em; +} +ul#mdbook-searchresults span.teaser em { + font-weight: bold; + font-style: normal; +} + +/* Sidebar */ + +.sidebar { + position: fixed; + left: 0; + top: 0; + bottom: 0; + width: var(--sidebar-width); + font-size: 0.875em; + box-sizing: border-box; + -webkit-overflow-scrolling: touch; + overscroll-behavior-y: contain; + background-color: var(--sidebar-bg); + color: var(--sidebar-fg); +} +.sidebar-iframe-inner { + --padding: 10px; + + background-color: var(--sidebar-bg); + padding: var(--padding); + margin: 0; + font-size: 1.4rem; + color: var(--sidebar-fg); + min-height: calc(100vh - var(--padding) * 2); +} +.sidebar-iframe-outer { + border: none; + height: 100%; + position: absolute; + top: 0; + bottom: 0; + left: 0; + right: 0; +} +[dir=rtl] .sidebar { left: unset; right: 0; } +.sidebar-resizing { + -moz-user-select: none; + -webkit-user-select: none; + -ms-user-select: none; + user-select: none; +} +html:not(.sidebar-resizing) .sidebar { + transition: transform 0.3s; /* Animation: slide away */ +} +.sidebar code { + line-height: 2em; +} +.sidebar .sidebar-scrollbox { + overflow-y: auto; + position: absolute; + top: 0; + bottom: 0; + left: 0; + right: 0; + padding: 10px 10px; +} +.sidebar .sidebar-resize-handle { + position: absolute; + cursor: col-resize; + width: 0; + right: calc(var(--sidebar-resize-indicator-width) * -1); + top: 0; + bottom: 0; + display: flex; + align-items: center; +} + +.sidebar-resize-handle .sidebar-resize-indicator { + width: 100%; + height: 16px; + color: var(--icons); + margin-inline-start: var(--sidebar-resize-indicator-space); + display: flex; + align-items: center; + justify-content: flex-start; +} +.sidebar-resize-handle .sidebar-resize-indicator::before { + content: ""; + width: 2px; + height: 12px; + border-left: dotted 2px currentColor; +} +.sidebar-resize-handle .sidebar-resize-indicator::after { + content: ""; + width: 2px; + height: 16px; + border-left: dotted 2px currentColor; +} + +[dir=rtl] .sidebar .sidebar-resize-handle { + left: calc(var(--sidebar-resize-indicator-width) * -1); + right: unset; +} +.js .sidebar .sidebar-resize-handle { + cursor: col-resize; + width: calc(var(--sidebar-resize-indicator-width) - var(--sidebar-resize-indicator-space)); +} + +html:not(.js) .sidebar-resize-handle { + display: none; +} + +/* sidebar-hidden */ +#mdbook-sidebar-toggle-anchor:not(:checked) ~ .sidebar { + transform: translateX(calc(0px - var(--sidebar-width) - var(--sidebar-resize-indicator-width))); +} +[dir=rtl] #mdbook-sidebar-toggle-anchor:not(:checked) ~ .sidebar { + transform: translateX(calc(var(--sidebar-width) + var(--sidebar-resize-indicator-width))); +} +.sidebar::-webkit-scrollbar { + background: var(--sidebar-bg); +} +.sidebar::-webkit-scrollbar-thumb { + background: var(--scrollbar); +} + +/* sidebar-visible */ +#mdbook-sidebar-toggle-anchor:checked ~ .page-wrapper { + transform: translateX(calc(var(--sidebar-width) + var(--sidebar-resize-indicator-width))); +} +[dir=rtl] #mdbook-sidebar-toggle-anchor:checked ~ .page-wrapper { + transform: translateX(calc(0px - var(--sidebar-width) - var(--sidebar-resize-indicator-width))); +} +@media only screen and (min-width: 620px) { + #mdbook-sidebar-toggle-anchor:checked ~ .page-wrapper { + transform: none; + margin-inline-start: calc(var(--sidebar-width) + var(--sidebar-resize-indicator-width)); + } + [dir=rtl] #mdbook-sidebar-toggle-anchor:checked ~ .page-wrapper { + transform: none; + } +} + +.chapter { + list-style: none outside none; + padding-inline-start: 0; + line-height: 2.2em; +} + +.chapter li { + color: var(--sidebar-non-existant); +} + +/* This is a span wrapping the chapter link and the fold chevron. */ +.chapter-link-wrapper { + /* Used to position the chevron to the right, allowing the text to wrap before it. */ + display: flex; +} + +.chapter li a { + /* Remove underlines. */ + text-decoration: none; + color: var(--sidebar-fg); +} + +.chapter li a:hover { + color: var(--sidebar-active); +} + +.chapter li a.active { + color: var(--sidebar-active); +} + +/* This is the toggle chevron. */ +.chapter-fold-toggle { + cursor: pointer; + /* Positions the chevron to the side. */ + margin-inline-start: auto; + padding: 0 10px; + user-select: none; + opacity: 0.68; +} + +.chapter-fold-toggle div { + transition: transform 0.5s; +} + +/* collapse the section */ +.chapter li:not(.expanded) > ol { + display: none; +} + +.chapter li.chapter-item { + line-height: 1.5em; + margin-block-start: 0.6em; +} + +/* When expanded, rotate the chevron to point down. */ +.chapter li.expanded > span > .chapter-fold-toggle div { + transform: rotate(90deg); +} + +.chapter a.current-header { + color: var(--sidebar-active); +} + +.on-this-page { + margin-left: 22px; + border-inline-start: 4px solid var(--sidebar-header-border-color); + padding-left: 8px; +} + +.on-this-page > ol { + padding-left: 0; +} + +/* Horizontal line in chapter list. */ +.spacer { + width: 100%; + height: 3px; + margin: 5px 0px; +} +.chapter .spacer { + background-color: var(--sidebar-spacer); +} + +/* On touch devices, add more vertical spacing to make it easier to tap links. */ +@media (-moz-touch-enabled: 1), (pointer: coarse) { + .chapter li a { padding: 5px 0; } + .spacer { margin: 10px 0; } +} + +.section { + list-style: none outside none; + padding-inline-start: 20px; + line-height: 1.9em; +} + +/* Theme Menu Popup */ + +.theme-popup { + position: absolute; + left: 10px; + top: var(--menu-bar-height); + z-index: 1000; + border-radius: 4px; + font-size: 0.7em; + color: var(--fg); + background: var(--theme-popup-bg); + border: 1px solid var(--theme-popup-border); + margin: 0; + padding: 0; + list-style: none; + display: none; + /* Don't let the children's background extend past the rounded corners. */ + overflow: hidden; +} +[dir=rtl] .theme-popup { left: unset; right: 10px; } +.theme-popup .default { + color: var(--icons); +} +.theme-popup .theme { + width: 100%; + border: 0; + margin: 0; + padding: 2px 20px; + line-height: 25px; + white-space: nowrap; + text-align: start; + cursor: pointer; + color: inherit; + background: inherit; + font-size: inherit; +} +.theme-popup .theme:hover { + background-color: var(--theme-hover); +} + +.theme-selected::before { + display: inline-block; + content: "โœ“"; + margin-inline-start: -14px; + width: 14px; +} + +/* The container for the help popup that covers the whole window. */ +#mdbook-help-container { + /* Position and size for the whole window. */ + position: fixed; + top: 0; + left: 0; + right: 0; + bottom: 0; + /* This uses flex layout (which is set in book.js), and centers the popup + in the window.*/ + display: none; + align-items: center; + justify-content: center; + z-index: 1000; + /* Dim out the book while the popup is visible. */ + background: var(--overlay-bg); +} + +/* The popup help box. */ +#mdbook-help-popup { + box-shadow: 0 4px 24px rgba(0,0,0,0.15); + min-width: 300px; + max-width: 500px; + width: 100%; + box-sizing: border-box; + display: flex; + flex-direction: column; + align-items: center; + background-color: var(--bg); + color: var(--fg); + border-width: 1px; + border-color: var(--theme-popup-border); + border-style: solid; + border-radius: 8px; + padding: 10px; +} + +.mdbook-help-title { + text-align: center; + /* mdbook's margin for h2 is way too large. */ + margin: 10px; +} diff --git a/docs/theme/css/general.css b/docs/theme/css/general.css new file mode 100644 index 00000000..df8a3efe --- /dev/null +++ b/docs/theme/css/general.css @@ -0,0 +1,408 @@ +/* Base styles and content styles */ + +:root { + /* Browser default font-size is 16px, this way 1 rem = 10px */ + font-size: 62.5%; + color-scheme: var(--color-scheme); +} + +html { + font-family: "Open Sans", sans-serif; + color: var(--fg); + background-color: var(--bg); + text-size-adjust: none; + -webkit-text-size-adjust: none; +} + +body { + margin: 0; + font-size: 1.6rem; + overflow-x: hidden; +} + +code { + font-family: var(--mono-font) !important; + font-size: var(--code-font-size); + direction: ltr !important; +} + +/* make long words/inline code not x overflow */ +main { + overflow-wrap: break-word; +} + +/* make wide tables scroll if they overflow */ +.table-wrapper { + overflow-x: auto; +} + +/* Don't change font size in headers. */ +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + font-size: unset; +} + +.left { float: left; } +.right { float: right; } +.boring { opacity: 0.6; } +.hide-boring .boring { display: none; } +.hidden { display: none !important; } + +h2, h3 { margin-block-start: 2.5em; } +h4, h5 { margin-block-start: 2em; } + +.header + .header h3, +.header + .header h4, +.header + .header h5 { + margin-block-start: 1em; +} + +h1:target::before, +h2:target::before, +h3:target::before, +h4:target::before, +h5:target::before, +h6:target::before, +dt:target::before { + display: inline-block; + content: "ยป"; + margin-inline-start: -30px; + width: 30px; +} + +/* This is broken on Safari as of version 14, but is fixed + in Safari Technology Preview 117 which I think will be Safari 14.2. + https://bugs.webkit.org/show_bug.cgi?id=218076 +*/ +:target { + /* Safari does not support logical properties */ + scroll-margin-top: calc(var(--menu-bar-height) + 0.5em); +} + +.page { + outline: 0; + padding: 0 var(--page-padding); + margin-block-start: calc(0px - var(--menu-bar-height)); /* Compensate for the #mdbook-menu-bar-hover-placeholder */ +} +.page-wrapper { + box-sizing: border-box; + background-color: var(--bg); +} +html:not(.js) .page-wrapper, +.js:not(.sidebar-resizing) .page-wrapper { + transition: margin-left 0.3s ease, transform 0.3s ease; /* Animation: slide away */ +} +[dir=rtl]:not(.js) .page-wrapper, +[dir=rtl].js:not(.sidebar-resizing) .page-wrapper { + transition: margin-right 0.3s ease, transform 0.3s ease; /* Animation: slide away */ +} + +.content { + overflow-y: auto; + padding: 0 5px 50px 5px; +} +.content main { + margin-inline-start: auto; + margin-inline-end: auto; + max-width: var(--content-max-width); +} +.content p { line-height: 1.45em; } +.content ol { line-height: 1.45em; } +.content ul { line-height: 1.45em; } +.content a { text-decoration: none; } +.content a:hover { text-decoration: underline; } +.content img, .content video { max-width: 100%; } +.content .header:link, +.content .header:visited { + color: var(--fg); +} +.content .header:link, +.content .header:visited:hover { + text-decoration: none; +} + +table { + margin: 0 auto; + border-collapse: collapse; +} +table td { + padding: 3px 20px; + border: 1px var(--table-border-color) solid; +} +table thead { + background: var(--table-header-bg); +} +table thead td { + font-weight: 700; + border: none; +} +table thead th { + padding: 3px 20px; +} +table thead tr { + border: 1px var(--table-header-bg) solid; +} +/* Alternate background colors for rows */ +table tbody tr:nth-child(2n) { + background: var(--table-alternate-bg); +} + + +blockquote { + margin: 20px 0; + padding: 0 20px; + color: var(--fg); + background-color: var(--quote-bg); + border-block-start: .1em solid var(--quote-border); + border-block-end: .1em solid var(--quote-border); +} + +/* TODO: Remove .warning in a future version of mdbook, it is replaced by +blockquote tags. */ +.warning { + margin: 20px; + padding: 0 20px; + border-inline-start: 2px solid var(--warning-border); +} + +.warning:before { + position: absolute; + width: 3rem; + height: 3rem; + margin-inline-start: calc(-1.5rem - 21px); + content: "โ“˜"; + text-align: center; + background-color: var(--bg); + color: var(--warning-border); + font-weight: bold; + font-size: 2rem; +} + +blockquote .warning:before { + background-color: var(--quote-bg); +} + +kbd { + background-color: var(--table-border-color); + border-radius: 4px; + border: solid 1px var(--theme-popup-border); + box-shadow: inset 0 -1px 0 var(--theme-hover); + display: inline-block; + font-size: var(--code-font-size); + font-family: var(--mono-font); + line-height: 10px; + padding: 4px 5px; + vertical-align: middle; +} + +sup { + /* Set the line-height for superscript and footnote references so that there + isn't an awkward space appearing above lines that contain the footnote. + + See https://github.com/rust-lang/mdBook/pull/2443#discussion_r1813773583 + for an explanation. + */ + line-height: 0; +} + +.footnote-definition { + font-size: 0.9em; +} +/* The default spacing for a list is a little too large. */ +.footnote-definition ul, +.footnote-definition ol { + padding-left: 20px; +} +.footnote-definition > li { + /* Required to position the ::before target */ + position: relative; +} +.footnote-definition > li:target { + scroll-margin-top: 50vh; +} +.footnote-reference:target { + scroll-margin-top: 50vh; +} +/* Draws a border around the footnote (including the marker) when it is selected. + TODO: If there are multiple linkbacks, highlight which one you just came + from so you know which one to click. +*/ +.footnote-definition > li:target::before { + border: 2px solid var(--footnote-highlight); + border-radius: 6px; + position: absolute; + top: -8px; + right: -8px; + bottom: -8px; + left: -32px; + pointer-events: none; + content: ""; +} +/* Pulses the footnote reference so you can quickly see where you left off reading. + This could use some improvement. +*/ +@media not (prefers-reduced-motion) { + .footnote-reference:target { + animation: fn-highlight 0.8s; + border-radius: 2px; + } + + @keyframes fn-highlight { + from { + background-color: var(--footnote-highlight); + } + } +} + +.tooltiptext { + position: absolute; + visibility: hidden; + color: #fff; + background-color: #333; + transform: translateX(-50%); /* Center by moving tooltip 50% of its width left */ + left: -8px; /* Half of the width of the icon */ + top: -35px; + font-size: 0.8em; + text-align: center; + border-radius: 6px; + padding: 5px 8px; + margin: 5px; + z-index: 1000; +} +.tooltipped .tooltiptext { + visibility: visible; +} + +.chapter li.part-title { + color: var(--sidebar-fg); + margin: 5px 0px; + font-weight: bold; +} + +.result-no-output { + font-style: italic; +} + +.fa-svg svg { + width: 1em; + height: 1em; + fill: currentColor; + margin-bottom: -0.1em; +} + +dt { + font-weight: bold; + margin-top: 0.5em; + margin-bottom: 0.1em; +} + +/* This uses a CSS counter to add numbers to definitions, but only if there is + more than one definition. */ +dl, dt { + counter-reset: dd-counter; +} + +/* When there is more than one definition, increment the counter. The first +selector selects the first definition, and the second one selects definitions +2 and beyond.*/ +dd:has(+ dd), dd + dd { + counter-increment: dd-counter; + /* Use flex display to help with positioning the numbers when there is a p + tag inside the definition. */ + display: flex; + align-items: flex-start; +} + +/* Shows the counter for definitions. The first selector selects the first +definition, and the second one selections definitions 2 and beyond.*/ +dd:has(+ dd)::before, dd + dd::before { + content: counter(dd-counter) ". "; + font-weight: 600; + display: inline-block; + margin-right: 0.5em; +} + +dd > p { + /* For loose definitions that have a p tag inside, don't add a bunch of + space before the definition. */ + margin-top: 0; +} + +/* Remove some excess space from the bottom. */ +.blockquote-tag p:last-child { + margin-bottom: 2px; +} + +.blockquote-tag { + /* Add some padding to make the vertical bar a little taller than the text.*/ + padding: 2px 0px 2px 20px; + /* Add a solid color bar on the left side. */ + border-inline-start-style: solid; + border-inline-start-width: 4px; + /* Disable the background color from normal blockquotes . */ + background-color: inherit; + /* Disable border blocks from blockquotes. */ + border-block-start: none; + border-block-end: none; +} + +.blockquote-tag-title svg { + fill: currentColor; + /* Add space between the icon and the title. */ + margin-right: 8px; +} + +.blockquote-tag-note { + border-inline-start-color: var(--blockquote-note-color); +} + +.blockquote-tag-tip { + border-inline-start-color: var(--blockquote-tip-color); +} + +.blockquote-tag-important { + border-inline-start-color: var(--blockquote-important-color); +} + +.blockquote-tag-warning { + border-inline-start-color: var(--blockquote-warning-color); +} + +.blockquote-tag-caution { + border-inline-start-color: var(--blockquote-caution-color); +} + +.blockquote-tag-note .blockquote-tag-title { + color: var(--blockquote-note-color); +} + +.blockquote-tag-tip .blockquote-tag-title { + color: var(--blockquote-tip-color); +} + +.blockquote-tag-important .blockquote-tag-title { + color: var(--blockquote-important-color); +} + +.blockquote-tag-warning .blockquote-tag-title { + color: var(--blockquote-warning-color); +} + +.blockquote-tag-caution .blockquote-tag-title { + color: var(--blockquote-caution-color); +} + +.blockquote-tag-title { + /* Slightly increase the weight for more emphasis. */ + font-weight: 600; + /* Vertically center the icon with the text. */ + display: flex; + align-items: center; + /* Remove default large margins for a more compact display. */ + margin: 2px 0 8px 0; +} + +.blockquote-tag-title .fa-svg { + fill: currentColor; + /* Add some space between the icon and the text. */ + margin-right: 8px; +} diff --git a/docs/theme/css/print.css b/docs/theme/css/print.css new file mode 100644 index 00000000..2004384d --- /dev/null +++ b/docs/theme/css/print.css @@ -0,0 +1,50 @@ + +#mdbook-sidebar, +#mdbook-menu-bar, +.nav-chapters, +.mobile-nav-chapters { + display: none; +} + +#mdbook-page-wrapper.page-wrapper { + transform: none !important; + margin-inline-start: 0px; + overflow-y: initial; +} + +#mdbook-content { + max-width: none; + margin: 0; + padding: 0; +} + +.page { + overflow-y: initial; +} + +code { + direction: ltr !important; +} + +pre > .buttons { + z-index: 2; +} + +a, a:visited, a:active, a:hover { + color: #4183c4; + text-decoration: none; +} + +h1, h2, h3, h4, h5, h6 { + page-break-inside: avoid; + page-break-after: avoid; +} + +pre, code { + page-break-inside: avoid; + white-space: pre-wrap; +} + +.fa { + display: none !important; +} diff --git a/docs/theme/css/variables.css b/docs/theme/css/variables.css new file mode 100644 index 00000000..af5023bc --- /dev/null +++ b/docs/theme/css/variables.css @@ -0,0 +1,383 @@ + +/* Globals */ + +:root { + --sidebar-target-width: 300px; + --sidebar-width: min(var(--sidebar-target-width), 80vw); + --sidebar-resize-indicator-width: 8px; + --sidebar-resize-indicator-space: 2px; + --page-padding: 15px; + --content-max-width: 750px; + --menu-bar-height: 50px; + --mono-font: "Source Code Pro", Consolas, "Ubuntu Mono", Menlo, "DejaVu Sans Mono", monospace, monospace; + --code-font-size: 0.875em; /* please adjust the ace font size accordingly in editor.js */ + --searchbar-margin-block-start: 5px; +} + +/* Themes */ + +.ayu { + --bg: hsl(210, 25%, 8%); + --fg: #c5c5c5; + + --sidebar-bg: #14191f; + --sidebar-fg: #c8c9db; + --sidebar-non-existant: #5c6773; + --sidebar-active: #ffb454; + --sidebar-spacer: #2d334f; + + --scrollbar: var(--sidebar-fg); + + --icons: #737480; + --icons-hover: #b7b9cc; + + --links: #0096cf; + + --inline-code-color: #ffb454; + + --theme-popup-bg: #14191f; + --theme-popup-border: #5c6773; + --theme-hover: #191f26; + + --quote-bg: hsl(226, 15%, 17%); + --quote-border: hsl(226, 15%, 22%); + + --warning-border: #ff8e00; + + --table-border-color: hsl(210, 25%, 13%); + --table-header-bg: hsl(210, 25%, 28%); + --table-alternate-bg: hsl(210, 25%, 11%); + + --searchbar-border-color: #848484; + --searchbar-bg: #424242; + --searchbar-fg: #fff; + --searchbar-shadow-color: #d4c89f; + --searchresults-header-fg: #666; + --searchresults-border-color: #888; + --searchresults-li-bg: #252932; + --search-mark-bg: #e3b171; + + --color-scheme: dark; + + /* Same as `--icons` */ + --copy-button-filter: invert(45%) sepia(6%) saturate(621%) hue-rotate(198deg) brightness(99%) contrast(85%); + /* Same as `--sidebar-active` */ + --copy-button-filter-hover: invert(68%) sepia(55%) saturate(531%) hue-rotate(341deg) brightness(104%) contrast(101%); + + --footnote-highlight: #2668a6; + + --overlay-bg: rgba(33, 40, 48, 0.4); + + --blockquote-note-color: #74b9ff; + --blockquote-tip-color: #09ca09; + --blockquote-important-color: #d3abff; + --blockquote-warning-color: #f0b72f; + --blockquote-caution-color: #f21424; + + --sidebar-header-border-color: #c18639; +} + +.coal { + --bg: hsl(200, 7%, 8%); + --fg: #98a3ad; + + --sidebar-bg: #292c2f; + --sidebar-fg: #a1adb8; + --sidebar-non-existant: #505254; + --sidebar-active: #3473ad; + --sidebar-spacer: #393939; + + --scrollbar: var(--sidebar-fg); + + --icons: #43484d; + --icons-hover: #b3c0cc; + + --links: #2b79a2; + + --inline-code-color: #c5c8c6; + + --theme-popup-bg: #141617; + --theme-popup-border: #43484d; + --theme-hover: #1f2124; + + --quote-bg: hsl(234, 21%, 18%); + --quote-border: hsl(234, 21%, 23%); + + --warning-border: #ff8e00; + + --table-border-color: hsl(200, 7%, 13%); + --table-header-bg: hsl(200, 7%, 28%); + --table-alternate-bg: hsl(200, 7%, 11%); + + --searchbar-border-color: #aaa; + --searchbar-bg: #b7b7b7; + --searchbar-fg: #000; + --searchbar-shadow-color: #aaa; + --searchresults-header-fg: #666; + --searchresults-border-color: #98a3ad; + --searchresults-li-bg: #2b2b2f; + --search-mark-bg: #355c7d; + + --color-scheme: dark; + + /* Same as `--icons` */ + --copy-button-filter: invert(26%) sepia(8%) saturate(575%) hue-rotate(169deg) brightness(87%) contrast(82%); + /* Same as `--sidebar-active` */ + --copy-button-filter-hover: invert(36%) sepia(70%) saturate(503%) hue-rotate(167deg) brightness(98%) contrast(89%); + + --footnote-highlight: #4079ae; + + --overlay-bg: rgba(33, 40, 48, 0.4); + + --blockquote-note-color: #4493f8; + --blockquote-tip-color: #08ae08; + --blockquote-important-color: #ab7df8; + --blockquote-warning-color: #d29922; + --blockquote-caution-color: #d91b29; + + --sidebar-header-border-color: #3473ad; +} + +.light, html:not(.js) { + --bg: hsl(0, 0%, 100%); + --fg: hsl(0, 0%, 0%); + + --sidebar-bg: #fafafa; + --sidebar-fg: hsl(0, 0%, 0%); + --sidebar-non-existant: #aaaaaa; + --sidebar-active: #1f1fff; + --sidebar-spacer: #f4f4f4; + + --scrollbar: #8F8F8F; + + --icons: #747474; + --icons-hover: #000000; + + --links: #20609f; + + --inline-code-color: #301900; + + --theme-popup-bg: #fafafa; + --theme-popup-border: #cccccc; + --theme-hover: #e6e6e6; + + --quote-bg: hsl(197, 37%, 96%); + --quote-border: hsl(197, 37%, 91%); + + --warning-border: #ff8e00; + + --table-border-color: hsl(0, 0%, 95%); + --table-header-bg: hsl(0, 0%, 80%); + --table-alternate-bg: hsl(0, 0%, 97%); + + --searchbar-border-color: #aaa; + --searchbar-bg: #fafafa; + --searchbar-fg: #000; + --searchbar-shadow-color: #aaa; + --searchresults-header-fg: #666; + --searchresults-border-color: #888; + --searchresults-li-bg: #e4f2fe; + --search-mark-bg: #a2cff5; + + --color-scheme: light; + + /* Same as `--icons` */ + --copy-button-filter: invert(45.49%); + /* Same as `--sidebar-active` */ + --copy-button-filter-hover: invert(14%) sepia(93%) saturate(4250%) hue-rotate(243deg) brightness(99%) contrast(130%); + + --footnote-highlight: #7e7eff; + + --overlay-bg: rgba(200, 200, 205, 0.4); + + --blockquote-note-color: #0969da; + --blockquote-tip-color: #008000; + --blockquote-important-color: #8250df; + --blockquote-warning-color: #9a6700; + --blockquote-caution-color: #b52731; + + --sidebar-header-border-color: #6e6edb; +} + +.navy { + --bg: hsl(226, 23%, 11%); + --fg: #bcbdd0; + + --sidebar-bg: #282d3f; + --sidebar-fg: #c8c9db; + --sidebar-non-existant: #505274; + --sidebar-active: #2b79a2; + --sidebar-spacer: #2d334f; + + --scrollbar: var(--sidebar-fg); + + --icons: #737480; + --icons-hover: #b7b9cc; + + --links: #2b79a2; + + --inline-code-color: #c5c8c6; + + --theme-popup-bg: #161923; + --theme-popup-border: #737480; + --theme-hover: #282e40; + + --quote-bg: hsl(226, 15%, 17%); + --quote-border: hsl(226, 15%, 22%); + + --warning-border: #ff8e00; + + --table-border-color: hsl(226, 23%, 16%); + --table-header-bg: hsl(226, 23%, 31%); + --table-alternate-bg: hsl(226, 23%, 14%); + + --searchbar-border-color: #aaa; + --searchbar-bg: #aeaec6; + --searchbar-fg: #000; + --searchbar-shadow-color: #aaa; + --searchresults-header-fg: #5f5f71; + --searchresults-border-color: #5c5c68; + --searchresults-li-bg: #242430; + --search-mark-bg: #a2cff5; + + --color-scheme: dark; + + /* Same as `--icons` */ + --copy-button-filter: invert(51%) sepia(10%) saturate(393%) hue-rotate(198deg) brightness(86%) contrast(87%); + /* Same as `--sidebar-active` */ + --copy-button-filter-hover: invert(46%) sepia(20%) saturate(1537%) hue-rotate(156deg) brightness(85%) contrast(90%); + + --footnote-highlight: #4079ae; + + --overlay-bg: rgba(33, 40, 48, 0.4); + + --blockquote-note-color: #4493f8; + --blockquote-tip-color: #09ca09; + --blockquote-important-color: #ab7df8; + --blockquote-warning-color: #d29922; + --blockquote-caution-color: #f21424; + + --sidebar-header-border-color: #2f6ab5; +} + +.rust { + --bg: hsl(60, 9%, 87%); + --fg: #262625; + + --sidebar-bg: #3b2e2a; + --sidebar-fg: #c8c9db; + --sidebar-non-existant: #505254; + --sidebar-active: #e69f67; + --sidebar-spacer: #45373a; + + --scrollbar: var(--sidebar-fg); + + --icons: #737480; + --icons-hover: #262625; + + --links: #2b79a2; + + --inline-code-color: #6e6b5e; + + --theme-popup-bg: #e1e1db; + --theme-popup-border: #b38f6b; + --theme-hover: #99908a; + + --quote-bg: hsl(60, 5%, 75%); + --quote-border: hsl(60, 5%, 70%); + + --warning-border: #ff8e00; + + --table-border-color: hsl(60, 9%, 82%); + --table-header-bg: #b3a497; + --table-alternate-bg: hsl(60, 9%, 84%); + + --searchbar-border-color: #aaa; + --searchbar-bg: #fafafa; + --searchbar-fg: #000; + --searchbar-shadow-color: #aaa; + --searchresults-header-fg: #666; + --searchresults-border-color: #888; + --searchresults-li-bg: #dec2a2; + --search-mark-bg: #e69f67; + + /* Same as `--icons` */ + --copy-button-filter: invert(51%) sepia(10%) saturate(393%) hue-rotate(198deg) brightness(86%) contrast(87%); + /* Same as `--sidebar-active` */ + --copy-button-filter-hover: invert(77%) sepia(16%) saturate(1798%) hue-rotate(328deg) brightness(98%) contrast(83%); + + --footnote-highlight: #d3a17a; + + --overlay-bg: rgba(150, 150, 150, 0.25); + + --blockquote-note-color: #023b95; + --blockquote-tip-color: #007700; + --blockquote-important-color: #8250df; + --blockquote-warning-color: #603700; + --blockquote-caution-color: #aa1721; + + --sidebar-header-border-color: #8c391f; +} + +@media (prefers-color-scheme: dark) { + html:not(.js) { + --bg: hsl(200, 7%, 8%); + --fg: #98a3ad; + + --sidebar-bg: #292c2f; + --sidebar-fg: #a1adb8; + --sidebar-non-existant: #505254; + --sidebar-active: #3473ad; + --sidebar-spacer: #393939; + + --scrollbar: var(--sidebar-fg); + + --icons: #43484d; + --icons-hover: #b3c0cc; + + --links: #2b79a2; + + --inline-code-color: #c5c8c6; + + --theme-popup-bg: #141617; + --theme-popup-border: #43484d; + --theme-hover: #1f2124; + + --quote-bg: hsl(234, 21%, 18%); + --quote-border: hsl(234, 21%, 23%); + + --warning-border: #ff8e00; + + --table-border-color: hsl(200, 7%, 13%); + --table-header-bg: hsl(200, 7%, 28%); + --table-alternate-bg: hsl(200, 7%, 11%); + + --searchbar-border-color: #aaa; + --searchbar-bg: #b7b7b7; + --searchbar-fg: #000; + --searchbar-shadow-color: #aaa; + --searchresults-header-fg: #666; + --searchresults-border-color: #98a3ad; + --searchresults-li-bg: #2b2b2f; + --search-mark-bg: #355c7d; + + --color-scheme: dark; + + /* Same as `--icons` */ + --copy-button-filter: invert(26%) sepia(8%) saturate(575%) hue-rotate(169deg) brightness(87%) contrast(82%); + /* Same as `--sidebar-active` */ + --copy-button-filter-hover: invert(36%) sepia(70%) saturate(503%) hue-rotate(167deg) brightness(98%) contrast(89%); + + --footnote-highlight: #4079ae; + + --overlay-bg: rgba(33, 40, 48, 0.4); + + --blockquote-note-color: #4493f8; + --blockquote-tip-color: #08ae08; + --blockquote-important-color: #ab7df8; + --blockquote-warning-color: #d29922; + --blockquote-caution-color: #d91b29; + + --sidebar-header-border-color: #3473ad; + } +} diff --git a/docs/theme/favicon.png b/docs/theme/favicon.png new file mode 100644 index 00000000..a5b1aa16 Binary files /dev/null and b/docs/theme/favicon.png differ diff --git a/docs/theme/favicon.svg b/docs/theme/favicon.svg new file mode 100644 index 00000000..90e0ea58 --- /dev/null +++ b/docs/theme/favicon.svg @@ -0,0 +1,22 @@ + + + + + diff --git a/docs/theme/fonts/OPEN-SANS-LICENSE.txt b/docs/theme/fonts/OPEN-SANS-LICENSE.txt new file mode 100644 index 00000000..d6456956 --- /dev/null +++ b/docs/theme/fonts/OPEN-SANS-LICENSE.txt @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/docs/theme/fonts/SOURCE-CODE-PRO-LICENSE.txt b/docs/theme/fonts/SOURCE-CODE-PRO-LICENSE.txt new file mode 100644 index 00000000..366206f5 --- /dev/null +++ b/docs/theme/fonts/SOURCE-CODE-PRO-LICENSE.txt @@ -0,0 +1,93 @@ +Copyright 2010, 2012 Adobe Systems Incorporated (http://www.adobe.com/), with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe Systems Incorporated in the United States and/or other countries. + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +http://scripts.sil.org/OFL + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/docs/theme/fonts/fonts.css b/docs/theme/fonts/fonts.css new file mode 100644 index 00000000..a6b12b3b --- /dev/null +++ b/docs/theme/fonts/fonts.css @@ -0,0 +1,100 @@ +/* Open Sans is licensed under the Apache License, Version 2.0. See http://www.apache.org/licenses/LICENSE-2.0 */ +/* Source Code Pro is under the Open Font License. See https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL */ + +/* open-sans-300 - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: normal; + font-weight: 300; + src: local('Open Sans Light'), local('OpenSans-Light'), + url('{{ resource "fonts/open-sans-v17-all-charsets-300.woff2" }}') format('woff2'); +} + +/* open-sans-300italic - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: italic; + font-weight: 300; + src: local('Open Sans Light Italic'), local('OpenSans-LightItalic'), + url('{{ resource "fonts/open-sans-v17-all-charsets-300italic.woff2" }}') format('woff2'); +} + +/* open-sans-regular - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: normal; + font-weight: 400; + src: local('Open Sans Regular'), local('OpenSans-Regular'), + url('{{ resource "fonts/open-sans-v17-all-charsets-regular.woff2" }}') format('woff2'); +} + +/* open-sans-italic - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: italic; + font-weight: 400; + src: local('Open Sans Italic'), local('OpenSans-Italic'), + url('{{ resource "fonts/open-sans-v17-all-charsets-italic.woff2" }}') format('woff2'); +} + +/* open-sans-600 - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: normal; + font-weight: 600; + src: local('Open Sans SemiBold'), local('OpenSans-SemiBold'), + url('{{ resource "fonts/open-sans-v17-all-charsets-600.woff2" }}') format('woff2'); +} + +/* open-sans-600italic - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: italic; + font-weight: 600; + src: local('Open Sans SemiBold Italic'), local('OpenSans-SemiBoldItalic'), + url('{{ resource "fonts/open-sans-v17-all-charsets-600italic.woff2" }}') format('woff2'); +} + +/* open-sans-700 - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: normal; + font-weight: 700; + src: local('Open Sans Bold'), local('OpenSans-Bold'), + url('{{ resource "fonts/open-sans-v17-all-charsets-700.woff2" }}') format('woff2'); +} + +/* open-sans-700italic - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: italic; + font-weight: 700; + src: local('Open Sans Bold Italic'), local('OpenSans-BoldItalic'), + url('{{ resource "fonts/open-sans-v17-all-charsets-700italic.woff2" }}') format('woff2'); +} + +/* open-sans-800 - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: normal; + font-weight: 800; + src: local('Open Sans ExtraBold'), local('OpenSans-ExtraBold'), + url('{{ resource "fonts/open-sans-v17-all-charsets-800.woff2" }}') format('woff2'); +} + +/* open-sans-800italic - latin_vietnamese_latin-ext_greek-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Open Sans'; + font-style: italic; + font-weight: 800; + src: local('Open Sans ExtraBold Italic'), local('OpenSans-ExtraBoldItalic'), + url('{{ resource "fonts/open-sans-v17-all-charsets-800italic.woff2" }}') format('woff2'); +} + +/* source-code-pro-500 - latin_vietnamese_latin-ext_greek_cyrillic-ext_cyrillic */ +@font-face { + font-family: 'Source Code Pro'; + font-style: normal; + font-weight: 500; + src: url('{{ resource "fonts/source-code-pro-v11-all-charsets-500.woff2" }}') format('woff2'); +} diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-300.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-300.woff2 new file mode 100644 index 00000000..9f51be37 Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-300.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-300italic.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-300italic.woff2 new file mode 100644 index 00000000..2f545448 Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-300italic.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-600.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-600.woff2 new file mode 100644 index 00000000..f503d558 Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-600.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-600italic.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-600italic.woff2 new file mode 100644 index 00000000..c99aabe8 Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-600italic.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-700.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-700.woff2 new file mode 100644 index 00000000..421a1ab2 Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-700.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-700italic.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-700italic.woff2 new file mode 100644 index 00000000..12ce3d20 Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-700italic.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-800.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-800.woff2 new file mode 100644 index 00000000..c94a223b Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-800.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-800italic.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-800italic.woff2 new file mode 100644 index 00000000..eed7d3c6 Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-800italic.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-italic.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-italic.woff2 new file mode 100644 index 00000000..398b68a0 Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-italic.woff2 differ diff --git a/docs/theme/fonts/open-sans-v17-all-charsets-regular.woff2 b/docs/theme/fonts/open-sans-v17-all-charsets-regular.woff2 new file mode 100644 index 00000000..8383e94c Binary files /dev/null and b/docs/theme/fonts/open-sans-v17-all-charsets-regular.woff2 differ diff --git a/docs/theme/fonts/source-code-pro-v11-all-charsets-500.woff2 b/docs/theme/fonts/source-code-pro-v11-all-charsets-500.woff2 new file mode 100644 index 00000000..72224568 Binary files /dev/null and b/docs/theme/fonts/source-code-pro-v11-all-charsets-500.woff2 differ diff --git a/docs/theme/highlight.css b/docs/theme/highlight.css new file mode 100644 index 00000000..352c79b9 --- /dev/null +++ b/docs/theme/highlight.css @@ -0,0 +1,83 @@ +/* + * An increased contrast highlighting scheme loosely based on the + * "Base16 Atelier Dune Light" theme by Bram de Haan + * (http://atelierbram.github.io/syntax-highlighting/atelier-schemes/dune) + * Original Base16 color scheme by Chris Kempson + * (https://github.com/chriskempson/base16) + */ + +/* Comment */ +.hljs-comment, +.hljs-quote { + color: #575757; +} + +/* Red */ +.hljs-variable, +.hljs-template-variable, +.hljs-attribute, +.hljs-attr, +.hljs-tag, +.hljs-name, +.hljs-regexp, +.hljs-link, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class { + color: #d70025; +} + +/* Orange */ +.hljs-number, +.hljs-meta, +.hljs-built_in, +.hljs-builtin-name, +.hljs-literal, +.hljs-type, +.hljs-params { + color: #b21e00; +} + +/* Green */ +.hljs-string, +.hljs-symbol, +.hljs-bullet { + color: #008200; +} + +/* Blue */ +.hljs-title, +.hljs-section { + color: #0030f2; +} + +/* Purple */ +.hljs-keyword, +.hljs-selector-tag { + color: #9d00ec; +} + +.hljs { + display: block; + overflow-x: auto; + background: #f6f7f6; + color: #000; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} + +.hljs-addition { + color: #22863a; + background-color: #f0fff4; +} + +.hljs-deletion { + color: #b31d28; + background-color: #ffeef0; +} diff --git a/docs/theme/highlight.js b/docs/theme/highlight.js new file mode 100644 index 00000000..18d24345 --- /dev/null +++ b/docs/theme/highlight.js @@ -0,0 +1,54 @@ +/* + Highlight.js 10.1.1 (93fd0d73) + License: BSD-3-Clause + Copyright (c) 2006-2020, Ivan Sagalaev +*/ +var hljs=function(){"use strict";function e(n){Object.freeze(n);var t="function"==typeof n;return Object.getOwnPropertyNames(n).forEach((function(r){!Object.hasOwnProperty.call(n,r)||null===n[r]||"object"!=typeof n[r]&&"function"!=typeof n[r]||t&&("caller"===r||"callee"===r||"arguments"===r)||Object.isFrozen(n[r])||e(n[r])})),n}class n{constructor(e){void 0===e.data&&(e.data={}),this.data=e.data}ignoreMatch(){this.ignore=!0}}function t(e){return e.replace(/&/g,"&").replace(//g,">").replace(/"/g,""").replace(/'/g,"'")}function r(e,...n){var t={};for(const n in e)t[n]=e[n];return n.forEach((function(e){for(const n in e)t[n]=e[n]})),t}function a(e){return e.nodeName.toLowerCase()}var i=Object.freeze({__proto__:null,escapeHTML:t,inherit:r,nodeStream:function(e){var n=[];return function e(t,r){for(var i=t.firstChild;i;i=i.nextSibling)3===i.nodeType?r+=i.nodeValue.length:1===i.nodeType&&(n.push({event:"start",offset:r,node:i}),r=e(i,r),a(i).match(/br|hr|img|input/)||n.push({event:"stop",offset:r,node:i}));return r}(e,0),n},mergeStreams:function(e,n,r){var i=0,s="",o=[];function l(){return e.length&&n.length?e[0].offset!==n[0].offset?e[0].offset"}function u(e){s+=""}function d(e){("start"===e.event?c:u)(e.node)}for(;e.length||n.length;){var g=l();if(s+=t(r.substring(i,g[0].offset)),i=g[0].offset,g===e){o.reverse().forEach(u);do{d(g.splice(0,1)[0]),g=l()}while(g===e&&g.length&&g[0].offset===i);o.reverse().forEach(c)}else"start"===g[0].event?o.push(g[0].node):o.pop(),d(g.splice(0,1)[0])}return s+t(r.substr(i))}});const s="",o=e=>!!e.kind;class l{constructor(e,n){this.buffer="",this.classPrefix=n.classPrefix,e.walk(this)}addText(e){this.buffer+=t(e)}openNode(e){if(!o(e))return;let n=e.kind;e.sublanguage||(n=`${this.classPrefix}${n}`),this.span(n)}closeNode(e){o(e)&&(this.buffer+=s)}value(){return this.buffer}span(e){this.buffer+=``}}class c{constructor(){this.rootNode={children:[]},this.stack=[this.rootNode]}get top(){return this.stack[this.stack.length-1]}get root(){return this.rootNode}add(e){this.top.children.push(e)}openNode(e){const n={kind:e,children:[]};this.add(n),this.stack.push(n)}closeNode(){if(this.stack.length>1)return this.stack.pop()}closeAllNodes(){for(;this.closeNode(););}toJSON(){return JSON.stringify(this.rootNode,null,4)}walk(e){return this.constructor._walk(e,this.rootNode)}static _walk(e,n){return"string"==typeof n?e.addText(n):n.children&&(e.openNode(n),n.children.forEach(n=>this._walk(e,n)),e.closeNode(n)),e}static _collapse(e){"string"!=typeof e&&e.children&&(e.children.every(e=>"string"==typeof e)?e.children=[e.children.join("")]:e.children.forEach(e=>{c._collapse(e)}))}}class u extends c{constructor(e){super(),this.options=e}addKeyword(e,n){""!==e&&(this.openNode(n),this.addText(e),this.closeNode())}addText(e){""!==e&&this.add(e)}addSublanguage(e,n){const t=e.root;t.kind=n,t.sublanguage=!0,this.add(t)}toHTML(){return new l(this,this.options).value()}finalize(){return!0}}function d(e){return e?"string"==typeof e?e:e.source:null}const g="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",h={begin:"\\\\[\\s\\S]",relevance:0},f={className:"string",begin:"'",end:"'",illegal:"\\n",contains:[h]},p={className:"string",begin:'"',end:'"',illegal:"\\n",contains:[h]},b={begin:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/},m=function(e,n,t={}){var a=r({className:"comment",begin:e,end:n,contains:[]},t);return a.contains.push(b),a.contains.push({className:"doctag",begin:"(?:TODO|FIXME|NOTE|BUG|OPTIMIZE|HACK|XXX):",relevance:0}),a},v=m("//","$"),x=m("/\\*","\\*/"),E=m("#","$");var _=Object.freeze({__proto__:null,IDENT_RE:"[a-zA-Z]\\w*",UNDERSCORE_IDENT_RE:"[a-zA-Z_]\\w*",NUMBER_RE:"\\b\\d+(\\.\\d+)?",C_NUMBER_RE:g,BINARY_NUMBER_RE:"\\b(0b[01]+)",RE_STARTERS_RE:"!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",SHEBANG:(e={})=>{const n=/^#![ ]*\//;return e.binary&&(e.begin=function(...e){return e.map(e=>d(e)).join("")}(n,/.*\b/,e.binary,/\b.*/)),r({className:"meta",begin:n,end:/$/,relevance:0,"on:begin":(e,n)=>{0!==e.index&&n.ignoreMatch()}},e)},BACKSLASH_ESCAPE:h,APOS_STRING_MODE:f,QUOTE_STRING_MODE:p,PHRASAL_WORDS_MODE:b,COMMENT:m,C_LINE_COMMENT_MODE:v,C_BLOCK_COMMENT_MODE:x,HASH_COMMENT_MODE:E,NUMBER_MODE:{className:"number",begin:"\\b\\d+(\\.\\d+)?",relevance:0},C_NUMBER_MODE:{className:"number",begin:g,relevance:0},BINARY_NUMBER_MODE:{className:"number",begin:"\\b(0b[01]+)",relevance:0},CSS_NUMBER_MODE:{className:"number",begin:"\\b\\d+(\\.\\d+)?(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",relevance:0},REGEXP_MODE:{begin:/(?=\/[^/\n]*\/)/,contains:[{className:"regexp",begin:/\//,end:/\/[gimuy]*/,illegal:/\n/,contains:[h,{begin:/\[/,end:/\]/,relevance:0,contains:[h]}]}]},TITLE_MODE:{className:"title",begin:"[a-zA-Z]\\w*",relevance:0},UNDERSCORE_TITLE_MODE:{className:"title",begin:"[a-zA-Z_]\\w*",relevance:0},METHOD_GUARD:{begin:"\\.\\s*[a-zA-Z_]\\w*",relevance:0},END_SAME_AS_BEGIN:function(e){return Object.assign(e,{"on:begin":(e,n)=>{n.data._beginMatch=e[1]},"on:end":(e,n)=>{n.data._beginMatch!==e[1]&&n.ignoreMatch()}})}}),N="of and for in not or if then".split(" ");function w(e,n){return n?+n:function(e){return N.includes(e.toLowerCase())}(e)?0:1}const R=t,y=r,{nodeStream:k,mergeStreams:O}=i,M=Symbol("nomatch");return function(t){var a=[],i={},s={},o=[],l=!0,c=/(^(<[^>]+>|\t|)+|\n)/gm,g="Could not find the language '{}', did you forget to load/include a language module?";const h={disableAutodetect:!0,name:"Plain text",contains:[]};var f={noHighlightRe:/^(no-?highlight)$/i,languageDetectRe:/\blang(?:uage)?-([\w-]+)\b/i,classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:null,__emitter:u};function p(e){return f.noHighlightRe.test(e)}function b(e,n,t,r){var a={code:n,language:e};S("before:highlight",a);var i=a.result?a.result:m(a.language,a.code,t,r);return i.code=a.code,S("after:highlight",i),i}function m(e,t,a,s){var o=t;function c(e,n){var t=E.case_insensitive?n[0].toLowerCase():n[0];return Object.prototype.hasOwnProperty.call(e.keywords,t)&&e.keywords[t]}function u(){null!=y.subLanguage?function(){if(""!==A){var e=null;if("string"==typeof y.subLanguage){if(!i[y.subLanguage])return void O.addText(A);e=m(y.subLanguage,A,!0,k[y.subLanguage]),k[y.subLanguage]=e.top}else e=v(A,y.subLanguage.length?y.subLanguage:null);y.relevance>0&&(I+=e.relevance),O.addSublanguage(e.emitter,e.language)}}():function(){if(!y.keywords)return void O.addText(A);let e=0;y.keywordPatternRe.lastIndex=0;let n=y.keywordPatternRe.exec(A),t="";for(;n;){t+=A.substring(e,n.index);const r=c(y,n);if(r){const[e,a]=r;O.addText(t),t="",I+=a,O.addKeyword(n[0],e)}else t+=n[0];e=y.keywordPatternRe.lastIndex,n=y.keywordPatternRe.exec(A)}t+=A.substr(e),O.addText(t)}(),A=""}function h(e){return e.className&&O.openNode(e.className),y=Object.create(e,{parent:{value:y}})}function p(e){return 0===y.matcher.regexIndex?(A+=e[0],1):(L=!0,0)}var b={};function x(t,r){var i=r&&r[0];if(A+=t,null==i)return u(),0;if("begin"===b.type&&"end"===r.type&&b.index===r.index&&""===i){if(A+=o.slice(r.index,r.index+1),!l){const n=Error("0 width match regex");throw n.languageName=e,n.badRule=b.rule,n}return 1}if(b=r,"begin"===r.type)return function(e){var t=e[0],r=e.rule;const a=new n(r),i=[r.__beforeBegin,r["on:begin"]];for(const n of i)if(n&&(n(e,a),a.ignore))return p(t);return r&&r.endSameAsBegin&&(r.endRe=RegExp(t.replace(/[-/\\^$*+?.()|[\]{}]/g,"\\$&"),"m")),r.skip?A+=t:(r.excludeBegin&&(A+=t),u(),r.returnBegin||r.excludeBegin||(A=t)),h(r),r.returnBegin?0:t.length}(r);if("illegal"===r.type&&!a){const e=Error('Illegal lexeme "'+i+'" for mode "'+(y.className||"")+'"');throw e.mode=y,e}if("end"===r.type){var s=function(e){var t=e[0],r=o.substr(e.index),a=function e(t,r,a){let i=function(e,n){var t=e&&e.exec(n);return t&&0===t.index}(t.endRe,a);if(i){if(t["on:end"]){const e=new n(t);t["on:end"](r,e),e.ignore&&(i=!1)}if(i){for(;t.endsParent&&t.parent;)t=t.parent;return t}}if(t.endsWithParent)return e(t.parent,r,a)}(y,e,r);if(!a)return M;var i=y;i.skip?A+=t:(i.returnEnd||i.excludeEnd||(A+=t),u(),i.excludeEnd&&(A=t));do{y.className&&O.closeNode(),y.skip||y.subLanguage||(I+=y.relevance),y=y.parent}while(y!==a.parent);return a.starts&&(a.endSameAsBegin&&(a.starts.endRe=a.endRe),h(a.starts)),i.returnEnd?0:t.length}(r);if(s!==M)return s}if("illegal"===r.type&&""===i)return 1;if(B>1e5&&B>3*r.index)throw Error("potential infinite loop, way more iterations than matches");return A+=i,i.length}var E=T(e);if(!E)throw console.error(g.replace("{}",e)),Error('Unknown language: "'+e+'"');var _=function(e){function n(n,t){return RegExp(d(n),"m"+(e.case_insensitive?"i":"")+(t?"g":""))}class t{constructor(){this.matchIndexes={},this.regexes=[],this.matchAt=1,this.position=0}addRule(e,n){n.position=this.position++,this.matchIndexes[this.matchAt]=n,this.regexes.push([n,e]),this.matchAt+=function(e){return RegExp(e.toString()+"|").exec("").length-1}(e)+1}compile(){0===this.regexes.length&&(this.exec=()=>null);const e=this.regexes.map(e=>e[1]);this.matcherRe=n(function(e,n="|"){for(var t=/\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./,r=0,a="",i=0;i0&&(a+=n),a+="(";o.length>0;){var l=t.exec(o);if(null==l){a+=o;break}a+=o.substring(0,l.index),o=o.substring(l.index+l[0].length),"\\"===l[0][0]&&l[1]?a+="\\"+(+l[1]+s):(a+=l[0],"("===l[0]&&r++)}a+=")"}return a}(e),!0),this.lastIndex=0}exec(e){this.matcherRe.lastIndex=this.lastIndex;const n=this.matcherRe.exec(e);if(!n)return null;const t=n.findIndex((e,n)=>n>0&&void 0!==e),r=this.matchIndexes[t];return n.splice(0,t),Object.assign(n,r)}}class a{constructor(){this.rules=[],this.multiRegexes=[],this.count=0,this.lastIndex=0,this.regexIndex=0}getMatcher(e){if(this.multiRegexes[e])return this.multiRegexes[e];const n=new t;return this.rules.slice(e).forEach(([e,t])=>n.addRule(e,t)),n.compile(),this.multiRegexes[e]=n,n}considerAll(){this.regexIndex=0}addRule(e,n){this.rules.push([e,n]),"begin"===n.type&&this.count++}exec(e){const n=this.getMatcher(this.regexIndex);n.lastIndex=this.lastIndex;const t=n.exec(e);return t&&(this.regexIndex+=t.position+1,this.regexIndex===this.count&&(this.regexIndex=0)),t}}function i(e,n){const t=e.input[e.index-1],r=e.input[e.index+e[0].length];"."!==t&&"."!==r||n.ignoreMatch()}if(e.contains&&e.contains.includes("self"))throw Error("ERR: contains `self` is not supported at the top-level of a language. See documentation.");return function t(s,o){const l=s;if(s.compiled)return l;s.compiled=!0,s.__beforeBegin=null,s.keywords=s.keywords||s.beginKeywords;let c=null;if("object"==typeof s.keywords&&(c=s.keywords.$pattern,delete s.keywords.$pattern),s.keywords&&(s.keywords=function(e,n){var t={};return"string"==typeof e?r("keyword",e):Object.keys(e).forEach((function(n){r(n,e[n])})),t;function r(e,r){n&&(r=r.toLowerCase()),r.split(" ").forEach((function(n){var r=n.split("|");t[r[0]]=[e,w(r[0],r[1])]}))}}(s.keywords,e.case_insensitive)),s.lexemes&&c)throw Error("ERR: Prefer `keywords.$pattern` to `mode.lexemes`, BOTH are not allowed. (see mode reference) ");return l.keywordPatternRe=n(s.lexemes||c||/\w+/,!0),o&&(s.beginKeywords&&(s.begin="\\b("+s.beginKeywords.split(" ").join("|")+")(?=\\b|\\s)",s.__beforeBegin=i),s.begin||(s.begin=/\B|\b/),l.beginRe=n(s.begin),s.endSameAsBegin&&(s.end=s.begin),s.end||s.endsWithParent||(s.end=/\B|\b/),s.end&&(l.endRe=n(s.end)),l.terminator_end=d(s.end)||"",s.endsWithParent&&o.terminator_end&&(l.terminator_end+=(s.end?"|":"")+o.terminator_end)),s.illegal&&(l.illegalRe=n(s.illegal)),void 0===s.relevance&&(s.relevance=1),s.contains||(s.contains=[]),s.contains=[].concat(...s.contains.map((function(e){return function(e){return e.variants&&!e.cached_variants&&(e.cached_variants=e.variants.map((function(n){return r(e,{variants:null},n)}))),e.cached_variants?e.cached_variants:function e(n){return!!n&&(n.endsWithParent||e(n.starts))}(e)?r(e,{starts:e.starts?r(e.starts):null}):Object.isFrozen(e)?r(e):e}("self"===e?s:e)}))),s.contains.forEach((function(e){t(e,l)})),s.starts&&t(s.starts,o),l.matcher=function(e){const n=new a;return e.contains.forEach(e=>n.addRule(e.begin,{rule:e,type:"begin"})),e.terminator_end&&n.addRule(e.terminator_end,{type:"end"}),e.illegal&&n.addRule(e.illegal,{type:"illegal"}),n}(l),l}(e)}(E),N="",y=s||_,k={},O=new f.__emitter(f);!function(){for(var e=[],n=y;n!==E;n=n.parent)n.className&&e.unshift(n.className);e.forEach(e=>O.openNode(e))}();var A="",I=0,S=0,B=0,L=!1;try{for(y.matcher.considerAll();;){B++,L?L=!1:(y.matcher.lastIndex=S,y.matcher.considerAll());const e=y.matcher.exec(o);if(!e)break;const n=x(o.substring(S,e.index),e);S=e.index+n}return x(o.substr(S)),O.closeAllNodes(),O.finalize(),N=O.toHTML(),{relevance:I,value:N,language:e,illegal:!1,emitter:O,top:y}}catch(n){if(n.message&&n.message.includes("Illegal"))return{illegal:!0,illegalBy:{msg:n.message,context:o.slice(S-100,S+100),mode:n.mode},sofar:N,relevance:0,value:R(o),emitter:O};if(l)return{illegal:!1,relevance:0,value:R(o),emitter:O,language:e,top:y,errorRaised:n};throw n}}function v(e,n){n=n||f.languages||Object.keys(i);var t=function(e){const n={relevance:0,emitter:new f.__emitter(f),value:R(e),illegal:!1,top:h};return n.emitter.addText(e),n}(e),r=t;return n.filter(T).filter(I).forEach((function(n){var a=m(n,e,!1);a.language=n,a.relevance>r.relevance&&(r=a),a.relevance>t.relevance&&(r=t,t=a)})),r.language&&(t.second_best=r),t}function x(e){return f.tabReplace||f.useBR?e.replace(c,e=>"\n"===e?f.useBR?"
":e:f.tabReplace?e.replace(/\t/g,f.tabReplace):e):e}function E(e){let n=null;const t=function(e){var n=e.className+" ";n+=e.parentNode?e.parentNode.className:"";const t=f.languageDetectRe.exec(n);if(t){var r=T(t[1]);return r||(console.warn(g.replace("{}",t[1])),console.warn("Falling back to no-highlight mode for this block.",e)),r?t[1]:"no-highlight"}return n.split(/\s+/).find(e=>p(e)||T(e))}(e);if(p(t))return;S("before:highlightBlock",{block:e,language:t}),f.useBR?(n=document.createElement("div")).innerHTML=e.innerHTML.replace(/\n/g,"").replace(//g,"\n"):n=e;const r=n.textContent,a=t?b(t,r,!0):v(r),i=k(n);if(i.length){const e=document.createElement("div");e.innerHTML=a.value,a.value=O(i,k(e),r)}a.value=x(a.value),S("after:highlightBlock",{block:e,result:a}),e.innerHTML=a.value,e.className=function(e,n,t){var r=n?s[n]:t,a=[e.trim()];return e.match(/\bhljs\b/)||a.push("hljs"),e.includes(r)||a.push(r),a.join(" ").trim()}(e.className,t,a.language),e.result={language:a.language,re:a.relevance,relavance:a.relevance},a.second_best&&(e.second_best={language:a.second_best.language,re:a.second_best.relevance,relavance:a.second_best.relevance})}const N=()=>{if(!N.called){N.called=!0;var e=document.querySelectorAll("pre code");a.forEach.call(e,E)}};function T(e){return e=(e||"").toLowerCase(),i[e]||i[s[e]]}function A(e,{languageName:n}){"string"==typeof e&&(e=[e]),e.forEach(e=>{s[e]=n})}function I(e){var n=T(e);return n&&!n.disableAutodetect}function S(e,n){var t=e;o.forEach((function(e){e[t]&&e[t](n)}))}Object.assign(t,{highlight:b,highlightAuto:v,fixMarkup:x,highlightBlock:E,configure:function(e){f=y(f,e)},initHighlighting:N,initHighlightingOnLoad:function(){window.addEventListener("DOMContentLoaded",N,!1)},registerLanguage:function(e,n){var r=null;try{r=n(t)}catch(n){if(console.error("Language definition for '{}' could not be registered.".replace("{}",e)),!l)throw n;console.error(n),r=h}r.name||(r.name=e),i[e]=r,r.rawDefinition=n.bind(null,t),r.aliases&&A(r.aliases,{languageName:e})},listLanguages:function(){return Object.keys(i)},getLanguage:T,registerAliases:A,requireLanguage:function(e){var n=T(e);if(n)return n;throw Error("The '{}' language is required, but not loaded.".replace("{}",e))},autoDetection:I,inherit:y,addPlugin:function(e){o.push(e)}}),t.debugMode=function(){l=!1},t.safeMode=function(){l=!0},t.versionString="10.1.1";for(const n in _)"object"==typeof _[n]&&e(_[n]);return Object.assign(t,_),t}({})}();"object"==typeof exports&&"undefined"!=typeof module&&(module.exports=hljs); +hljs.registerLanguage("apache",function(){"use strict";return function(e){var n={className:"number",begin:"\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}(:\\d{1,5})?"};return{name:"Apache config",aliases:["apacheconf"],case_insensitive:!0,contains:[e.HASH_COMMENT_MODE,{className:"section",begin:"",contains:[n,{className:"number",begin:":\\d{1,5}"},e.inherit(e.QUOTE_STRING_MODE,{relevance:0})]},{className:"attribute",begin:/\w+/,relevance:0,keywords:{nomarkup:"order deny allow setenv rewriterule rewriteengine rewritecond documentroot sethandler errordocument loadmodule options header listen serverroot servername"},starts:{end:/$/,relevance:0,keywords:{literal:"on off all deny allow"},contains:[{className:"meta",begin:"\\s\\[",end:"\\]$"},{className:"variable",begin:"[\\$%]\\{",end:"\\}",contains:["self",{className:"number",begin:"[\\$%]\\d+"}]},n,{className:"number",begin:"\\d+"},e.QUOTE_STRING_MODE]}}],illegal:/\S/}}}()); +hljs.registerLanguage("bash",function(){"use strict";return function(e){const s={};Object.assign(s,{className:"variable",variants:[{begin:/\$[\w\d#@][\w\d_]*/},{begin:/\$\{/,end:/\}/,contains:[{begin:/:-/,contains:[s]}]}]});const t={className:"subst",begin:/\$\(/,end:/\)/,contains:[e.BACKSLASH_ESCAPE]},n={className:"string",begin:/"/,end:/"/,contains:[e.BACKSLASH_ESCAPE,s,t]};t.contains.push(n);const a={begin:/\$\(\(/,end:/\)\)/,contains:[{begin:/\d+#[0-9a-f]+/,className:"number"},e.NUMBER_MODE,s]},i=e.SHEBANG({binary:"(fish|bash|zsh|sh|csh|ksh|tcsh|dash|scsh)",relevance:10}),c={className:"function",begin:/\w[\w\d_]*\s*\(\s*\)\s*\{/,returnBegin:!0,contains:[e.inherit(e.TITLE_MODE,{begin:/\w[\w\d_]*/})],relevance:0};return{name:"Bash",aliases:["sh","zsh"],keywords:{$pattern:/\b-?[a-z\._]+\b/,keyword:"if then else elif fi for while in do done case esac function",literal:"true false",built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp",_:"-ne -eq -lt -gt -f -d -e -s -l -a"},contains:[i,e.SHEBANG(),c,a,e.HASH_COMMENT_MODE,n,{className:"",begin:/\\"/},{className:"string",begin:/'/,end:/'/},s]}}}()); +hljs.registerLanguage("c-like",function(){"use strict";return function(e){function t(e){return"(?:"+e+")?"}var n="(decltype\\(auto\\)|"+t("[a-zA-Z_]\\w*::")+"[a-zA-Z_]\\w*"+t("<.*?>")+")",r={className:"keyword",begin:"\\b[a-z\\d_]*_t\\b"},a={className:"string",variants:[{begin:'(u8?|U|L)?"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{begin:"(u8?|U|L)?'(\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)|.)",end:"'",illegal:"."},e.END_SAME_AS_BEGIN({begin:/(?:u8?|U|L)?R"([^()\\ ]{0,16})\(/,end:/\)([^()\\ ]{0,16})"/})]},i={className:"number",variants:[{begin:"\\b(0b[01']+)"},{begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)"}],relevance:0},s={className:"meta",begin:/#\s*[a-z]+\b/,end:/$/,keywords:{"meta-keyword":"if else elif endif define undef warning error line pragma _Pragma ifdef ifndef include"},contains:[{begin:/\\\n/,relevance:0},e.inherit(a,{className:"meta-string"}),{className:"meta-string",begin:/<.*?>/,end:/$/,illegal:"\\n"},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},o={className:"title",begin:t("[a-zA-Z_]\\w*::")+e.IDENT_RE,relevance:0},c=t("[a-zA-Z_]\\w*::")+e.IDENT_RE+"\\s*\\(",l={keyword:"int float while private char char8_t char16_t char32_t catch import module export virtual operator sizeof dynamic_cast|10 typedef const_cast|10 const for static_cast|10 union namespace unsigned long volatile static protected bool template mutable if public friend do goto auto void enum else break extern using asm case typeid wchar_t short reinterpret_cast|10 default double register explicit signed typename try this switch continue inline delete alignas alignof constexpr consteval constinit decltype concept co_await co_return co_yield requires noexcept static_assert thread_local restrict final override atomic_bool atomic_char atomic_schar atomic_uchar atomic_short atomic_ushort atomic_int atomic_uint atomic_long atomic_ulong atomic_llong atomic_ullong new throw return and and_eq bitand bitor compl not not_eq or or_eq xor xor_eq",built_in:"std string wstring cin cout cerr clog stdin stdout stderr stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set pair bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap priority_queue make_pair array shared_ptr abort terminate abs acos asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp fscanf future isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit tolower toupper labs ldexp log10 log malloc realloc memchr memcmp memcpy memset modf pow printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan vfprintf vprintf vsprintf endl initializer_list unique_ptr _Bool complex _Complex imaginary _Imaginary",literal:"true false nullptr NULL"},d=[r,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,i,a],_={variants:[{begin:/=/,end:/;/},{begin:/\(/,end:/\)/},{beginKeywords:"new throw return else",end:/;/}],keywords:l,contains:d.concat([{begin:/\(/,end:/\)/,keywords:l,contains:d.concat(["self"]),relevance:0}]),relevance:0},u={className:"function",begin:"("+n+"[\\*&\\s]+)+"+c,returnBegin:!0,end:/[{;=]/,excludeEnd:!0,keywords:l,illegal:/[^\w\s\*&:<>]/,contains:[{begin:"decltype\\(auto\\)",keywords:l,relevance:0},{begin:c,returnBegin:!0,contains:[o],relevance:0},{className:"params",begin:/\(/,end:/\)/,keywords:l,relevance:0,contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,a,i,r,{begin:/\(/,end:/\)/,keywords:l,relevance:0,contains:["self",e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,a,i,r]}]},r,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,s]};return{aliases:["c","cc","h","c++","h++","hpp","hh","hxx","cxx"],keywords:l,disableAutodetect:!0,illegal:"",keywords:l,contains:["self",r]},{begin:e.IDENT_RE+"::",keywords:l},{className:"class",beginKeywords:"class struct",end:/[{;:]/,contains:[{begin://,contains:["self"]},e.TITLE_MODE]}]),exports:{preprocessor:s,strings:a,keywords:l}}}}()); +hljs.registerLanguage("c",function(){"use strict";return function(e){var n=e.getLanguage("c-like").rawDefinition();return n.name="C",n.aliases=["c","h"],n}}()); +hljs.registerLanguage("coffeescript",function(){"use strict";const e=["as","in","of","if","for","while","finally","var","new","function","do","return","void","else","break","catch","instanceof","with","throw","case","default","try","switch","continue","typeof","delete","let","yield","const","class","debugger","async","await","static","import","from","export","extends"],n=["true","false","null","undefined","NaN","Infinity"],a=[].concat(["setInterval","setTimeout","clearInterval","clearTimeout","require","exports","eval","isFinite","isNaN","parseFloat","parseInt","decodeURI","decodeURIComponent","encodeURI","encodeURIComponent","escape","unescape"],["arguments","this","super","console","window","document","localStorage","module","global"],["Intl","DataView","Number","Math","Date","String","RegExp","Object","Function","Boolean","Error","Symbol","Set","Map","WeakSet","WeakMap","Proxy","Reflect","JSON","Promise","Float64Array","Int16Array","Int32Array","Int8Array","Uint16Array","Uint32Array","Float32Array","Array","Uint8Array","Uint8ClampedArray","ArrayBuffer"],["EvalError","InternalError","RangeError","ReferenceError","SyntaxError","TypeError","URIError"]);return function(r){var t={keyword:e.concat(["then","unless","until","loop","by","when","and","or","is","isnt","not"]).filter((e=>n=>!e.includes(n))(["var","const","let","function","static"])).join(" "),literal:n.concat(["yes","no","on","off"]).join(" "),built_in:a.concat(["npm","print"]).join(" ")},i="[A-Za-z$_][0-9A-Za-z$_]*",s={className:"subst",begin:/#\{/,end:/}/,keywords:t},o=[r.BINARY_NUMBER_MODE,r.inherit(r.C_NUMBER_MODE,{starts:{end:"(\\s*/)?",relevance:0}}),{className:"string",variants:[{begin:/'''/,end:/'''/,contains:[r.BACKSLASH_ESCAPE]},{begin:/'/,end:/'/,contains:[r.BACKSLASH_ESCAPE]},{begin:/"""/,end:/"""/,contains:[r.BACKSLASH_ESCAPE,s]},{begin:/"/,end:/"/,contains:[r.BACKSLASH_ESCAPE,s]}]},{className:"regexp",variants:[{begin:"///",end:"///",contains:[s,r.HASH_COMMENT_MODE]},{begin:"//[gim]{0,3}(?=\\W)",relevance:0},{begin:/\/(?![ *]).*?(?![\\]).\/[gim]{0,3}(?=\W)/}]},{begin:"@"+i},{subLanguage:"javascript",excludeBegin:!0,excludeEnd:!0,variants:[{begin:"```",end:"```"},{begin:"`",end:"`"}]}];s.contains=o;var c=r.inherit(r.TITLE_MODE,{begin:i}),l={className:"params",begin:"\\([^\\(]",returnBegin:!0,contains:[{begin:/\(/,end:/\)/,keywords:t,contains:["self"].concat(o)}]};return{name:"CoffeeScript",aliases:["coffee","cson","iced"],keywords:t,illegal:/\/\*/,contains:o.concat([r.COMMENT("###","###"),r.HASH_COMMENT_MODE,{className:"function",begin:"^\\s*"+i+"\\s*=\\s*(\\(.*\\))?\\s*\\B[-=]>",end:"[-=]>",returnBegin:!0,contains:[c,l]},{begin:/[:\(,=]\s*/,relevance:0,contains:[{className:"function",begin:"(\\(.*\\))?\\s*\\B[-=]>",end:"[-=]>",returnBegin:!0,contains:[l]}]},{className:"class",beginKeywords:"class",end:"$",illegal:/[:="\[\]]/,contains:[{beginKeywords:"extends",endsWithParent:!0,illegal:/[:="\[\]]/,contains:[c]},c]},{begin:i+":",end:":",returnBegin:!0,returnEnd:!0,relevance:0}])}}}()); +hljs.registerLanguage("cpp",function(){"use strict";return function(e){var t=e.getLanguage("c-like").rawDefinition();return t.disableAutodetect=!1,t.name="C++",t.aliases=["cc","c++","h++","hpp","hh","hxx","cxx"],t}}()); +hljs.registerLanguage("csharp",function(){"use strict";return function(e){var n={keyword:"abstract as base bool break byte case catch char checked const continue decimal default delegate do double enum event explicit extern finally fixed float for foreach goto if implicit in int interface internal is lock long object operator out override params private protected public readonly ref sbyte sealed short sizeof stackalloc static string struct switch this try typeof uint ulong unchecked unsafe ushort using virtual void volatile while add alias ascending async await by descending dynamic equals from get global group into join let nameof on orderby partial remove select set value var when where yield",literal:"null false true"},i=e.inherit(e.TITLE_MODE,{begin:"[a-zA-Z](\\.?\\w)*"}),a={className:"number",variants:[{begin:"\\b(0b[01']+)"},{begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)"}],relevance:0},s={className:"string",begin:'@"',end:'"',contains:[{begin:'""'}]},t=e.inherit(s,{illegal:/\n/}),l={className:"subst",begin:"{",end:"}",keywords:n},r=e.inherit(l,{illegal:/\n/}),c={className:"string",begin:/\$"/,end:'"',illegal:/\n/,contains:[{begin:"{{"},{begin:"}}"},e.BACKSLASH_ESCAPE,r]},o={className:"string",begin:/\$@"/,end:'"',contains:[{begin:"{{"},{begin:"}}"},{begin:'""'},l]},g=e.inherit(o,{illegal:/\n/,contains:[{begin:"{{"},{begin:"}}"},{begin:'""'},r]});l.contains=[o,c,s,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.C_BLOCK_COMMENT_MODE],r.contains=[g,c,t,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.inherit(e.C_BLOCK_COMMENT_MODE,{illegal:/\n/})];var d={variants:[o,c,s,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},E={begin:"<",end:">",contains:[{beginKeywords:"in out"},i]},_=e.IDENT_RE+"(<"+e.IDENT_RE+"(\\s*,\\s*"+e.IDENT_RE+")*>)?(\\[\\])?",b={begin:"@"+e.IDENT_RE,relevance:0};return{name:"C#",aliases:["cs","c#"],keywords:n,illegal:/::/,contains:[e.COMMENT("///","$",{returnBegin:!0,contains:[{className:"doctag",variants:[{begin:"///",relevance:0},{begin:"\x3c!--|--\x3e"},{begin:""}]}]}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{className:"meta",begin:"#",end:"$",keywords:{"meta-keyword":"if else elif endif define undef warning error line region endregion pragma checksum"}},d,a,{beginKeywords:"class interface",end:/[{;=]/,illegal:/[^\s:,]/,contains:[{beginKeywords:"where class"},i,E,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{beginKeywords:"namespace",end:/[{;=]/,illegal:/[^\s:]/,contains:[i,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"meta",begin:"^\\s*\\[",excludeBegin:!0,end:"\\]",excludeEnd:!0,contains:[{className:"meta-string",begin:/"/,end:/"/}]},{beginKeywords:"new return throw await else",relevance:0},{className:"function",begin:"("+_+"\\s+)+"+e.IDENT_RE+"\\s*(\\<.+\\>)?\\s*\\(",returnBegin:!0,end:/\s*[{;=]/,excludeEnd:!0,keywords:n,contains:[{begin:e.IDENT_RE+"\\s*(\\<.+\\>)?\\s*\\(",returnBegin:!0,contains:[e.TITLE_MODE,E],relevance:0},{className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:n,relevance:0,contains:[d,a,e.C_BLOCK_COMMENT_MODE]},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},b]}}}()); +hljs.registerLanguage("css",function(){"use strict";return function(e){var n={begin:/(?:[A-Z\_\.\-]+|--[a-zA-Z0-9_-]+)\s*:/,returnBegin:!0,end:";",endsWithParent:!0,contains:[{className:"attribute",begin:/\S/,end:":",excludeEnd:!0,starts:{endsWithParent:!0,excludeEnd:!0,contains:[{begin:/[\w-]+\(/,returnBegin:!0,contains:[{className:"built_in",begin:/[\w-]+/},{begin:/\(/,end:/\)/,contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.CSS_NUMBER_MODE]}]},e.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,e.C_BLOCK_COMMENT_MODE,{className:"number",begin:"#[0-9A-Fa-f]+"},{className:"meta",begin:"!important"}]}}]};return{name:"CSS",case_insensitive:!0,illegal:/[=\/|'\$]/,contains:[e.C_BLOCK_COMMENT_MODE,{className:"selector-id",begin:/#[A-Za-z0-9_-]+/},{className:"selector-class",begin:/\.[A-Za-z0-9_-]+/},{className:"selector-attr",begin:/\[/,end:/\]/,illegal:"$",contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},{className:"selector-pseudo",begin:/:(:)?[a-zA-Z0-9\_\-\+\(\)"'.]+/},{begin:"@(page|font-face)",lexemes:"@[a-z-]+",keywords:"@page @font-face"},{begin:"@",end:"[{;]",illegal:/:/,returnBegin:!0,contains:[{className:"keyword",begin:/@\-?\w[\w]*(\-\w+)*/},{begin:/\s/,endsWithParent:!0,excludeEnd:!0,relevance:0,keywords:"and or not only",contains:[{begin:/[a-z-]+:/,className:"attribute"},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.CSS_NUMBER_MODE]}]},{className:"selector-tag",begin:"[a-zA-Z-][a-zA-Z0-9_-]*",relevance:0},{begin:"{",end:"}",illegal:/\S/,contains:[e.C_BLOCK_COMMENT_MODE,n]}]}}}()); +hljs.registerLanguage("diff",function(){"use strict";return function(e){return{name:"Diff",aliases:["patch"],contains:[{className:"meta",relevance:10,variants:[{begin:/^@@ +\-\d+,\d+ +\+\d+,\d+ +@@$/},{begin:/^\*\*\* +\d+,\d+ +\*\*\*\*$/},{begin:/^\-\-\- +\d+,\d+ +\-\-\-\-$/}]},{className:"comment",variants:[{begin:/Index: /,end:/$/},{begin:/={3,}/,end:/$/},{begin:/^\-{3}/,end:/$/},{begin:/^\*{3} /,end:/$/},{begin:/^\+{3}/,end:/$/},{begin:/^\*{15}$/}]},{className:"addition",begin:"^\\+",end:"$"},{className:"deletion",begin:"^\\-",end:"$"},{className:"addition",begin:"^\\!",end:"$"}]}}}()); +hljs.registerLanguage("go",function(){"use strict";return function(e){var n={keyword:"break default func interface select case map struct chan else goto package switch const fallthrough if range type continue for import return var go defer bool byte complex64 complex128 float32 float64 int8 int16 int32 int64 string uint8 uint16 uint32 uint64 int uint uintptr rune",literal:"true false iota nil",built_in:"append cap close complex copy imag len make new panic print println real recover delete"};return{name:"Go",aliases:["golang"],keywords:n,illegal:"e(n)).join("")}return function(a){var s={className:"number",relevance:0,variants:[{begin:/([\+\-]+)?[\d]+_[\d_]+/},{begin:a.NUMBER_RE}]},i=a.COMMENT();i.variants=[{begin:/;/,end:/$/},{begin:/#/,end:/$/}];var t={className:"variable",variants:[{begin:/\$[\w\d"][\w\d_]*/},{begin:/\$\{(.*?)}/}]},r={className:"literal",begin:/\bon|off|true|false|yes|no\b/},l={className:"string",contains:[a.BACKSLASH_ESCAPE],variants:[{begin:"'''",end:"'''",relevance:10},{begin:'"""',end:'"""',relevance:10},{begin:'"',end:'"'},{begin:"'",end:"'"}]},c={begin:/\[/,end:/\]/,contains:[i,r,t,l,s,"self"],relevance:0},g="("+[/[A-Za-z0-9_-]+/,/"(\\"|[^"])*"/,/'[^']*'/].map(n=>e(n)).join("|")+")";return{name:"TOML, also INI",aliases:["toml"],case_insensitive:!0,illegal:/\S/,contains:[i,{className:"section",begin:/\[+/,end:/\]+/},{begin:n(g,"(\\s*\\.\\s*",g,")*",n("(?=",/\s*=\s*[^#\s]/,")")),className:"attr",starts:{end:/$/,contains:[i,c,r,t,l,s]}}]}}}()); +hljs.registerLanguage("java",function(){"use strict";function e(e){return e?"string"==typeof e?e:e.source:null}function n(e){return a("(",e,")?")}function a(...n){return n.map(n=>e(n)).join("")}function s(...n){return"("+n.map(n=>e(n)).join("|")+")"}return function(e){var t="false synchronized int abstract float private char boolean var static null if const for true while long strictfp finally protected import native final void enum else break transient catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private module requires exports do",i={className:"meta",begin:"@[ร€-สธa-zA-Z_$][ร€-สธa-zA-Z_$0-9]*",contains:[{begin:/\(/,end:/\)/,contains:["self"]}]},r=e=>a("[",e,"]+([",e,"_]*[",e,"]+)?"),c={className:"number",variants:[{begin:`\\b(0[bB]${r("01")})[lL]?`},{begin:`\\b(0${r("0-7")})[dDfFlL]?`},{begin:a(/\b0[xX]/,s(a(r("a-fA-F0-9"),/\./,r("a-fA-F0-9")),a(r("a-fA-F0-9"),/\.?/),a(/\./,r("a-fA-F0-9"))),/([pP][+-]?(\d+))?/,/[fFdDlL]?/)},{begin:a(/\b/,s(a(/\d*\./,r("\\d")),r("\\d")),/[eE][+-]?[\d]+[dDfF]?/)},{begin:a(/\b/,r(/\d/),n(/\.?/),n(r(/\d/)),/[dDfFlL]?/)}],relevance:0};return{name:"Java",aliases:["jsp"],keywords:t,illegal:/<\/|#/,contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{begin:/\w+@/,relevance:0},{className:"doctag",begin:"@[A-Za-z]+"}]}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{className:"class",beginKeywords:"class interface",end:/[{;=]/,excludeEnd:!0,keywords:"class interface",illegal:/[:"\[\]]/,contains:[{beginKeywords:"extends implements"},e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"new throw return else",relevance:0},{className:"function",begin:"([ร€-สธa-zA-Z_$][ร€-สธa-zA-Z_$0-9]*(<[ร€-สธa-zA-Z_$][ร€-สธa-zA-Z_$0-9]*(\\s*,\\s*[ร€-สธa-zA-Z_$][ร€-สธa-zA-Z_$0-9]*)*>)?\\s+)+"+e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,end:/[{;=]/,excludeEnd:!0,keywords:t,contains:[{begin:e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,relevance:0,contains:[e.UNDERSCORE_TITLE_MODE]},{className:"params",begin:/\(/,end:/\)/,keywords:t,relevance:0,contains:[i,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.C_NUMBER_MODE,e.C_BLOCK_COMMENT_MODE]},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},c,i]}}}()); +hljs.registerLanguage("javascript",function(){"use strict";const e=["as","in","of","if","for","while","finally","var","new","function","do","return","void","else","break","catch","instanceof","with","throw","case","default","try","switch","continue","typeof","delete","let","yield","const","class","debugger","async","await","static","import","from","export","extends"],n=["true","false","null","undefined","NaN","Infinity"],a=[].concat(["setInterval","setTimeout","clearInterval","clearTimeout","require","exports","eval","isFinite","isNaN","parseFloat","parseInt","decodeURI","decodeURIComponent","encodeURI","encodeURIComponent","escape","unescape"],["arguments","this","super","console","window","document","localStorage","module","global"],["Intl","DataView","Number","Math","Date","String","RegExp","Object","Function","Boolean","Error","Symbol","Set","Map","WeakSet","WeakMap","Proxy","Reflect","JSON","Promise","Float64Array","Int16Array","Int32Array","Int8Array","Uint16Array","Uint32Array","Float32Array","Array","Uint8Array","Uint8ClampedArray","ArrayBuffer"],["EvalError","InternalError","RangeError","ReferenceError","SyntaxError","TypeError","URIError"]);function s(e){return r("(?=",e,")")}function r(...e){return e.map(e=>(function(e){return e?"string"==typeof e?e:e.source:null})(e)).join("")}return function(t){var i="[A-Za-z$_][0-9A-Za-z$_]*",c={begin:/<[A-Za-z0-9\\._:-]+/,end:/\/[A-Za-z0-9\\._:-]+>|\/>/},o={$pattern:"[A-Za-z$_][0-9A-Za-z$_]*",keyword:e.join(" "),literal:n.join(" "),built_in:a.join(" ")},l={className:"number",variants:[{begin:"\\b(0[bB][01]+)n?"},{begin:"\\b(0[oO][0-7]+)n?"},{begin:t.C_NUMBER_RE+"n?"}],relevance:0},E={className:"subst",begin:"\\$\\{",end:"\\}",keywords:o,contains:[]},d={begin:"html`",end:"",starts:{end:"`",returnEnd:!1,contains:[t.BACKSLASH_ESCAPE,E],subLanguage:"xml"}},g={begin:"css`",end:"",starts:{end:"`",returnEnd:!1,contains:[t.BACKSLASH_ESCAPE,E],subLanguage:"css"}},u={className:"string",begin:"`",end:"`",contains:[t.BACKSLASH_ESCAPE,E]};E.contains=[t.APOS_STRING_MODE,t.QUOTE_STRING_MODE,d,g,u,l,t.REGEXP_MODE];var b=E.contains.concat([{begin:/\(/,end:/\)/,contains:["self"].concat(E.contains,[t.C_BLOCK_COMMENT_MODE,t.C_LINE_COMMENT_MODE])},t.C_BLOCK_COMMENT_MODE,t.C_LINE_COMMENT_MODE]),_={className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,contains:b};return{name:"JavaScript",aliases:["js","jsx","mjs","cjs"],keywords:o,contains:[t.SHEBANG({binary:"node",relevance:5}),{className:"meta",relevance:10,begin:/^\s*['"]use (strict|asm)['"]/},t.APOS_STRING_MODE,t.QUOTE_STRING_MODE,d,g,u,t.C_LINE_COMMENT_MODE,t.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{className:"doctag",begin:"@[A-Za-z]+",contains:[{className:"type",begin:"\\{",end:"\\}",relevance:0},{className:"variable",begin:i+"(?=\\s*(-)|$)",endsParent:!0,relevance:0},{begin:/(?=[^\n])\s/,relevance:0}]}]}),t.C_BLOCK_COMMENT_MODE,l,{begin:r(/[{,\n]\s*/,s(r(/(((\/\/.*)|(\/\*(.|\n)*\*\/))\s*)*/,i+"\\s*:"))),relevance:0,contains:[{className:"attr",begin:i+s("\\s*:"),relevance:0}]},{begin:"("+t.RE_STARTERS_RE+"|\\b(case|return|throw)\\b)\\s*",keywords:"return throw case",contains:[t.C_LINE_COMMENT_MODE,t.C_BLOCK_COMMENT_MODE,t.REGEXP_MODE,{className:"function",begin:"(\\([^(]*(\\([^(]*(\\([^(]*\\))?\\))?\\)|"+t.UNDERSCORE_IDENT_RE+")\\s*=>",returnBegin:!0,end:"\\s*=>",contains:[{className:"params",variants:[{begin:t.UNDERSCORE_IDENT_RE},{className:null,begin:/\(\s*\)/,skip:!0},{begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:o,contains:b}]}]},{begin:/,/,relevance:0},{className:"",begin:/\s/,end:/\s*/,skip:!0},{variants:[{begin:"<>",end:""},{begin:c.begin,end:c.end}],subLanguage:"xml",contains:[{begin:c.begin,end:c.end,skip:!0,contains:["self"]}]}],relevance:0},{className:"function",beginKeywords:"function",end:/\{/,excludeEnd:!0,contains:[t.inherit(t.TITLE_MODE,{begin:i}),_],illegal:/\[|%/},{begin:/\$[(.]/},t.METHOD_GUARD,{className:"class",beginKeywords:"class",end:/[{;=]/,excludeEnd:!0,illegal:/[:"\[\]]/,contains:[{beginKeywords:"extends"},t.UNDERSCORE_TITLE_MODE]},{beginKeywords:"constructor",end:/\{/,excludeEnd:!0},{begin:"(get|set)\\s+(?="+i+"\\()",end:/{/,keywords:"get set",contains:[t.inherit(t.TITLE_MODE,{begin:i}),{begin:/\(\)/},_]}],illegal:/#(?!!)/}}}()); +hljs.registerLanguage("json",function(){"use strict";return function(n){var e={literal:"true false null"},i=[n.C_LINE_COMMENT_MODE,n.C_BLOCK_COMMENT_MODE],t=[n.QUOTE_STRING_MODE,n.C_NUMBER_MODE],a={end:",",endsWithParent:!0,excludeEnd:!0,contains:t,keywords:e},l={begin:"{",end:"}",contains:[{className:"attr",begin:/"/,end:/"/,contains:[n.BACKSLASH_ESCAPE],illegal:"\\n"},n.inherit(a,{begin:/:/})].concat(i),illegal:"\\S"},s={begin:"\\[",end:"\\]",contains:[n.inherit(a)],illegal:"\\S"};return t.push(l,s),i.forEach((function(n){t.push(n)})),{name:"JSON",contains:t,keywords:e,illegal:"\\S"}}}()); +hljs.registerLanguage("kotlin",function(){"use strict";return function(e){var n={keyword:"abstract as val var vararg get set class object open private protected public noinline crossinline dynamic final enum if else do while for when throw try catch finally import package is in fun override companion reified inline lateinit init interface annotation data sealed internal infix operator out by constructor super tailrec where const inner suspend typealias external expect actual trait volatile transient native default",built_in:"Byte Short Char Int Long Boolean Float Double Void Unit Nothing",literal:"true false null"},a={className:"symbol",begin:e.UNDERSCORE_IDENT_RE+"@"},i={className:"subst",begin:"\\${",end:"}",contains:[e.C_NUMBER_MODE]},s={className:"variable",begin:"\\$"+e.UNDERSCORE_IDENT_RE},t={className:"string",variants:[{begin:'"""',end:'"""(?=[^"])',contains:[s,i]},{begin:"'",end:"'",illegal:/\n/,contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"',illegal:/\n/,contains:[e.BACKSLASH_ESCAPE,s,i]}]};i.contains.push(t);var r={className:"meta",begin:"@(?:file|property|field|get|set|receiver|param|setparam|delegate)\\s*:(?:\\s*"+e.UNDERSCORE_IDENT_RE+")?"},l={className:"meta",begin:"@"+e.UNDERSCORE_IDENT_RE,contains:[{begin:/\(/,end:/\)/,contains:[e.inherit(t,{className:"meta-string"})]}]},c=e.COMMENT("/\\*","\\*/",{contains:[e.C_BLOCK_COMMENT_MODE]}),o={variants:[{className:"type",begin:e.UNDERSCORE_IDENT_RE},{begin:/\(/,end:/\)/,contains:[]}]},d=o;return d.variants[1].contains=[o],o.variants[1].contains=[d],{name:"Kotlin",aliases:["kt"],keywords:n,contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{className:"doctag",begin:"@[A-Za-z]+"}]}),e.C_LINE_COMMENT_MODE,c,{className:"keyword",begin:/\b(break|continue|return|this)\b/,starts:{contains:[{className:"symbol",begin:/@\w+/}]}},a,r,l,{className:"function",beginKeywords:"fun",end:"[(]|$",returnBegin:!0,excludeEnd:!0,keywords:n,illegal:/fun\s+(<.*>)?[^\s\(]+(\s+[^\s\(]+)\s*=/,relevance:5,contains:[{begin:e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,relevance:0,contains:[e.UNDERSCORE_TITLE_MODE]},{className:"type",begin://,keywords:"reified",relevance:0},{className:"params",begin:/\(/,end:/\)/,endsParent:!0,keywords:n,relevance:0,contains:[{begin:/:/,end:/[=,\/]/,endsWithParent:!0,contains:[o,e.C_LINE_COMMENT_MODE,c],relevance:0},e.C_LINE_COMMENT_MODE,c,r,l,t,e.C_NUMBER_MODE]},c]},{className:"class",beginKeywords:"class interface trait",end:/[:\{(]|$/,excludeEnd:!0,illegal:"extends implements",contains:[{beginKeywords:"public protected internal private constructor"},e.UNDERSCORE_TITLE_MODE,{className:"type",begin://,excludeBegin:!0,excludeEnd:!0,relevance:0},{className:"type",begin:/[,:]\s*/,end:/[<\(,]|$/,excludeBegin:!0,returnEnd:!0},r,l]},t,{className:"meta",begin:"^#!/usr/bin/env",end:"$",illegal:"\n"},{className:"number",begin:"\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",relevance:0}]}}}()); +hljs.registerLanguage("less",function(){"use strict";return function(e){var n="([\\w-]+|@{[\\w-]+})",a=[],s=[],t=function(e){return{className:"string",begin:"~?"+e+".*?"+e}},r=function(e,n,a){return{className:e,begin:n,relevance:a}},i={begin:"\\(",end:"\\)",contains:s,relevance:0};s.push(e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,t("'"),t('"'),e.CSS_NUMBER_MODE,{begin:"(url|data-uri)\\(",starts:{className:"string",end:"[\\)\\n]",excludeEnd:!0}},r("number","#[0-9A-Fa-f]+\\b"),i,r("variable","@@?[\\w-]+",10),r("variable","@{[\\w-]+}"),r("built_in","~?`[^`]*?`"),{className:"attribute",begin:"[\\w-]+\\s*:",end:":",returnBegin:!0,excludeEnd:!0},{className:"meta",begin:"!important"});var c=s.concat({begin:"{",end:"}",contains:a}),l={beginKeywords:"when",endsWithParent:!0,contains:[{beginKeywords:"and not"}].concat(s)},o={begin:n+"\\s*:",returnBegin:!0,end:"[;}]",relevance:0,contains:[{className:"attribute",begin:n,end:":",excludeEnd:!0,starts:{endsWithParent:!0,illegal:"[<=$]",relevance:0,contains:s}}]},g={className:"keyword",begin:"@(import|media|charset|font-face|(-[a-z]+-)?keyframes|supports|document|namespace|page|viewport|host)\\b",starts:{end:"[;{}]",returnEnd:!0,contains:s,relevance:0}},d={className:"variable",variants:[{begin:"@[\\w-]+\\s*:",relevance:15},{begin:"@[\\w-]+"}],starts:{end:"[;}]",returnEnd:!0,contains:c}},b={variants:[{begin:"[\\.#:&\\[>]",end:"[;{}]"},{begin:n,end:"{"}],returnBegin:!0,returnEnd:!0,illegal:"[<='$\"]",relevance:0,contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,l,r("keyword","all\\b"),r("variable","@{[\\w-]+}"),r("selector-tag",n+"%?",0),r("selector-id","#"+n),r("selector-class","\\."+n,0),r("selector-tag","&",0),{className:"selector-attr",begin:"\\[",end:"\\]"},{className:"selector-pseudo",begin:/:(:)?[a-zA-Z0-9\_\-\+\(\)"'.]+/},{begin:"\\(",end:"\\)",contains:c},{begin:"!important"}]};return a.push(e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,g,d,o,b),{name:"Less",case_insensitive:!0,illegal:"[=>'/<($\"]",contains:a}}}()); +hljs.registerLanguage("lua",function(){"use strict";return function(e){var t={begin:"\\[=*\\[",end:"\\]=*\\]",contains:["self"]},a=[e.COMMENT("--(?!\\[=*\\[)","$"),e.COMMENT("--\\[=*\\[","\\]=*\\]",{contains:[t],relevance:10})];return{name:"Lua",keywords:{$pattern:e.UNDERSCORE_IDENT_RE,literal:"true false nil",keyword:"and break do else elseif end for goto if in local not or repeat return then until while",built_in:"_G _ENV _VERSION __index __newindex __mode __call __metatable __tostring __len __gc __add __sub __mul __div __mod __pow __concat __unm __eq __lt __le assert collectgarbage dofile error getfenv getmetatable ipairs load loadfile loadstring module next pairs pcall print rawequal rawget rawset require select setfenv setmetatable tonumber tostring type unpack xpcall arg self coroutine resume yield status wrap create running debug getupvalue debug sethook getmetatable gethook setmetatable setlocal traceback setfenv getinfo setupvalue getlocal getregistry getfenv io lines write close flush open output type read stderr stdin input stdout popen tmpfile math log max acos huge ldexp pi cos tanh pow deg tan cosh sinh random randomseed frexp ceil floor rad abs sqrt modf asin min mod fmod log10 atan2 exp sin atan os exit setlocale date getenv difftime remove time clock tmpname rename execute package preload loadlib loaded loaders cpath config path seeall string sub upper len gfind rep find match char dump gmatch reverse byte format gsub lower table setn insert getn foreachi maxn foreach concat sort remove"},contains:a.concat([{className:"function",beginKeywords:"function",end:"\\)",contains:[e.inherit(e.TITLE_MODE,{begin:"([_a-zA-Z]\\w*\\.)*([_a-zA-Z]\\w*:)?[_a-zA-Z]\\w*"}),{className:"params",begin:"\\(",endsWithParent:!0,contains:a}].concat(a)},e.C_NUMBER_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{className:"string",begin:"\\[=*\\[",end:"\\]=*\\]",contains:[t],relevance:5}])}}}()); +hljs.registerLanguage("makefile",function(){"use strict";return function(e){var i={className:"variable",variants:[{begin:"\\$\\("+e.UNDERSCORE_IDENT_RE+"\\)",contains:[e.BACKSLASH_ESCAPE]},{begin:/\$[@%`]+/}]}]}]};return{name:"HTML, XML",aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist","wsf","svg"],case_insensitive:!0,contains:[{className:"meta",begin:"",relevance:10,contains:[a,i,t,s,{begin:"\\[",end:"\\]",contains:[{className:"meta",begin:"",contains:[a,s,i,t]}]}]},e.COMMENT("\x3c!--","--\x3e",{relevance:10}),{begin:"<\\!\\[CDATA\\[",end:"\\]\\]>",relevance:10},n,{className:"meta",begin:/<\?xml/,end:/\?>/,relevance:10},{className:"tag",begin:")",end:">",keywords:{name:"style"},contains:[c],starts:{end:"",returnEnd:!0,subLanguage:["css","xml"]}},{className:"tag",begin:")",end:">",keywords:{name:"script"},contains:[c],starts:{end:"<\/script>",returnEnd:!0,subLanguage:["javascript","handlebars","xml"]}},{className:"tag",begin:"",contains:[{className:"name",begin:/[^\/><\s]+/,relevance:0},c]}]}}}()); +hljs.registerLanguage("markdown",function(){"use strict";return function(n){const e={begin:"<",end:">",subLanguage:"xml",relevance:0},a={begin:"\\[.+?\\][\\(\\[].*?[\\)\\]]",returnBegin:!0,contains:[{className:"string",begin:"\\[",end:"\\]",excludeBegin:!0,returnEnd:!0,relevance:0},{className:"link",begin:"\\]\\(",end:"\\)",excludeBegin:!0,excludeEnd:!0},{className:"symbol",begin:"\\]\\[",end:"\\]",excludeBegin:!0,excludeEnd:!0}],relevance:10},i={className:"strong",contains:[],variants:[{begin:/_{2}/,end:/_{2}/},{begin:/\*{2}/,end:/\*{2}/}]},s={className:"emphasis",contains:[],variants:[{begin:/\*(?!\*)/,end:/\*/},{begin:/_(?!_)/,end:/_/,relevance:0}]};i.contains.push(s),s.contains.push(i);var c=[e,a];return i.contains=i.contains.concat(c),s.contains=s.contains.concat(c),{name:"Markdown",aliases:["md","mkdown","mkd"],contains:[{className:"section",variants:[{begin:"^#{1,6}",end:"$",contains:c=c.concat(i,s)},{begin:"(?=^.+?\\n[=-]{2,}$)",contains:[{begin:"^[=-]*$"},{begin:"^",end:"\\n",contains:c}]}]},e,{className:"bullet",begin:"^[ \t]*([*+-]|(\\d+\\.))(?=\\s+)",end:"\\s+",excludeEnd:!0},i,s,{className:"quote",begin:"^>\\s+",contains:c,end:"$"},{className:"code",variants:[{begin:"(`{3,})(.|\\n)*?\\1`*[ ]*"},{begin:"(~{3,})(.|\\n)*?\\1~*[ ]*"},{begin:"```",end:"```+[ ]*$"},{begin:"~~~",end:"~~~+[ ]*$"},{begin:"`.+?`"},{begin:"(?=^( {4}|\\t))",contains:[{begin:"^( {4}|\\t)",end:"(\\n)$"}],relevance:0}]},{begin:"^[-\\*]{3,}",end:"$"},a,{begin:/^\[[^\n]+\]:/,returnBegin:!0,contains:[{className:"symbol",begin:/\[/,end:/\]/,excludeBegin:!0,excludeEnd:!0},{className:"link",begin:/:\s*/,end:/$/,excludeBegin:!0}]}]}}}()); +hljs.registerLanguage("nginx",function(){"use strict";return function(e){var n={className:"variable",variants:[{begin:/\$\d+/},{begin:/\$\{/,end:/}/},{begin:"[\\$\\@]"+e.UNDERSCORE_IDENT_RE}]},a={endsWithParent:!0,keywords:{$pattern:"[a-z/_]+",literal:"on off yes no true false none blocked debug info notice warn error crit select break last permanent redirect kqueue rtsig epoll poll /dev/poll"},relevance:0,illegal:"=>",contains:[e.HASH_COMMENT_MODE,{className:"string",contains:[e.BACKSLASH_ESCAPE,n],variants:[{begin:/"/,end:/"/},{begin:/'/,end:/'/}]},{begin:"([a-z]+):/",end:"\\s",endsWithParent:!0,excludeEnd:!0,contains:[n]},{className:"regexp",contains:[e.BACKSLASH_ESCAPE,n],variants:[{begin:"\\s\\^",end:"\\s|{|;",returnEnd:!0},{begin:"~\\*?\\s+",end:"\\s|{|;",returnEnd:!0},{begin:"\\*(\\.[a-z\\-]+)+"},{begin:"([a-z\\-]+\\.)+\\*"}]},{className:"number",begin:"\\b\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}(:\\d{1,5})?\\b"},{className:"number",begin:"\\b\\d+[kKmMgGdshdwy]*\\b",relevance:0},n]};return{name:"Nginx config",aliases:["nginxconf"],contains:[e.HASH_COMMENT_MODE,{begin:e.UNDERSCORE_IDENT_RE+"\\s+{",returnBegin:!0,end:"{",contains:[{className:"section",begin:e.UNDERSCORE_IDENT_RE}],relevance:0},{begin:e.UNDERSCORE_IDENT_RE+"\\s",end:";|{",returnBegin:!0,contains:[{className:"attribute",begin:e.UNDERSCORE_IDENT_RE,starts:a}],relevance:0}],illegal:"[^\\s\\}]"}}}()); +hljs.registerLanguage("objectivec",function(){"use strict";return function(e){var n=/[a-zA-Z@][a-zA-Z0-9_]*/,_={$pattern:n,keyword:"@interface @class @protocol @implementation"};return{name:"Objective-C",aliases:["mm","objc","obj-c"],keywords:{$pattern:n,keyword:"int float while char export sizeof typedef const struct for union unsigned long volatile static bool mutable if do return goto void enum else break extern asm case short default double register explicit signed typename this switch continue wchar_t inline readonly assign readwrite self @synchronized id typeof nonatomic super unichar IBOutlet IBAction strong weak copy in out inout bycopy byref oneway __strong __weak __block __autoreleasing @private @protected @public @try @property @end @throw @catch @finally @autoreleasepool @synthesize @dynamic @selector @optional @required @encode @package @import @defs @compatibility_alias __bridge __bridge_transfer __bridge_retained __bridge_retain __covariant __contravariant __kindof _Nonnull _Nullable _Null_unspecified __FUNCTION__ __PRETTY_FUNCTION__ __attribute__ getter setter retain unsafe_unretained nonnull nullable null_unspecified null_resettable class instancetype NS_DESIGNATED_INITIALIZER NS_UNAVAILABLE NS_REQUIRES_SUPER NS_RETURNS_INNER_POINTER NS_INLINE NS_AVAILABLE NS_DEPRECATED NS_ENUM NS_OPTIONS NS_SWIFT_UNAVAILABLE NS_ASSUME_NONNULL_BEGIN NS_ASSUME_NONNULL_END NS_REFINED_FOR_SWIFT NS_SWIFT_NAME NS_SWIFT_NOTHROW NS_DURING NS_HANDLER NS_ENDHANDLER NS_VALUERETURN NS_VOIDRETURN",literal:"false true FALSE TRUE nil YES NO NULL",built_in:"BOOL dispatch_once_t dispatch_queue_t dispatch_sync dispatch_async dispatch_once"},illegal:"/,end:/$/,illegal:"\\n"},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"class",begin:"("+_.keyword.split(" ").join("|")+")\\b",end:"({|$)",excludeEnd:!0,keywords:_,contains:[e.UNDERSCORE_TITLE_MODE]},{begin:"\\."+e.UNDERSCORE_IDENT_RE,relevance:0}]}}}()); +hljs.registerLanguage("perl",function(){"use strict";return function(e){var n={$pattern:/[\w.]+/,keyword:"getpwent getservent quotemeta msgrcv scalar kill dbmclose undef lc ma syswrite tr send umask sysopen shmwrite vec qx utime local oct semctl localtime readpipe do return format read sprintf dbmopen pop getpgrp not getpwnam rewinddir qq fileno qw endprotoent wait sethostent bless s|0 opendir continue each sleep endgrent shutdown dump chomp connect getsockname die socketpair close flock exists index shmget sub for endpwent redo lstat msgctl setpgrp abs exit select print ref gethostbyaddr unshift fcntl syscall goto getnetbyaddr join gmtime symlink semget splice x|0 getpeername recv log setsockopt cos last reverse gethostbyname getgrnam study formline endhostent times chop length gethostent getnetent pack getprotoent getservbyname rand mkdir pos chmod y|0 substr endnetent printf next open msgsnd readdir use unlink getsockopt getpriority rindex wantarray hex system getservbyport endservent int chr untie rmdir prototype tell listen fork shmread ucfirst setprotoent else sysseek link getgrgid shmctl waitpid unpack getnetbyname reset chdir grep split require caller lcfirst until warn while values shift telldir getpwuid my getprotobynumber delete and sort uc defined srand accept package seekdir getprotobyname semop our rename seek if q|0 chroot sysread setpwent no crypt getc chown sqrt write setnetent setpriority foreach tie sin msgget map stat getlogin unless elsif truncate exec keys glob tied closedir ioctl socket readlink eval xor readline binmode setservent eof ord bind alarm pipe atan2 getgrent exp time push setgrent gt lt or ne m|0 break given say state when"},t={className:"subst",begin:"[$@]\\{",end:"\\}",keywords:n},s={begin:"->{",end:"}"},r={variants:[{begin:/\$\d/},{begin:/[\$%@](\^\w\b|#\w+(::\w+)*|{\w+}|\w+(::\w*)*)/},{begin:/[\$%@][^\s\w{]/,relevance:0}]},i=[e.BACKSLASH_ESCAPE,t,r],a=[r,e.HASH_COMMENT_MODE,e.COMMENT("^\\=\\w","\\=cut",{endsWithParent:!0}),s,{className:"string",contains:i,variants:[{begin:"q[qwxr]?\\s*\\(",end:"\\)",relevance:5},{begin:"q[qwxr]?\\s*\\[",end:"\\]",relevance:5},{begin:"q[qwxr]?\\s*\\{",end:"\\}",relevance:5},{begin:"q[qwxr]?\\s*\\|",end:"\\|",relevance:5},{begin:"q[qwxr]?\\s*\\<",end:"\\>",relevance:5},{begin:"qw\\s+q",end:"q",relevance:5},{begin:"'",end:"'",contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"'},{begin:"`",end:"`",contains:[e.BACKSLASH_ESCAPE]},{begin:"{\\w+}",contains:[],relevance:0},{begin:"-?\\w+\\s*\\=\\>",contains:[],relevance:0}]},{className:"number",begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",relevance:0},{begin:"(\\/\\/|"+e.RE_STARTERS_RE+"|\\b(split|return|print|reverse|grep)\\b)\\s*",keywords:"split return print reverse grep",relevance:0,contains:[e.HASH_COMMENT_MODE,{className:"regexp",begin:"(s|tr|y)/(\\\\.|[^/])*/(\\\\.|[^/])*/[a-z]*",relevance:10},{className:"regexp",begin:"(m|qr)?/",end:"/[a-z]*",contains:[e.BACKSLASH_ESCAPE],relevance:0}]},{className:"function",beginKeywords:"sub",end:"(\\s*\\(.*?\\))?[;{]",excludeEnd:!0,relevance:5,contains:[e.TITLE_MODE]},{begin:"-\\w\\b",relevance:0},{begin:"^__DATA__$",end:"^__END__$",subLanguage:"mojolicious",contains:[{begin:"^@@.*",end:"$",className:"comment"}]}];return t.contains=a,s.contains=a,{name:"Perl",aliases:["pl","pm"],keywords:n,contains:a}}}()); +hljs.registerLanguage("php",function(){"use strict";return function(e){var r={begin:"\\$+[a-zA-Z_-รฟ][a-zA-Z0-9_-รฟ]*"},t={className:"meta",variants:[{begin:/<\?php/,relevance:10},{begin:/<\?[=]?/},{begin:/\?>/}]},a={className:"string",contains:[e.BACKSLASH_ESCAPE,t],variants:[{begin:'b"',end:'"'},{begin:"b'",end:"'"},e.inherit(e.APOS_STRING_MODE,{illegal:null}),e.inherit(e.QUOTE_STRING_MODE,{illegal:null})]},n={variants:[e.BINARY_NUMBER_MODE,e.C_NUMBER_MODE]},i={keyword:"__CLASS__ __DIR__ __FILE__ __FUNCTION__ __LINE__ __METHOD__ __NAMESPACE__ __TRAIT__ die echo exit include include_once print require require_once array abstract and as binary bool boolean break callable case catch class clone const continue declare default do double else elseif empty enddeclare endfor endforeach endif endswitch endwhile eval extends final finally float for foreach from global goto if implements instanceof insteadof int integer interface isset iterable list new object or private protected public real return string switch throw trait try unset use var void while xor yield",literal:"false null true",built_in:"Error|0 AppendIterator ArgumentCountError ArithmeticError ArrayIterator ArrayObject AssertionError BadFunctionCallException BadMethodCallException CachingIterator CallbackFilterIterator CompileError Countable DirectoryIterator DivisionByZeroError DomainException EmptyIterator ErrorException Exception FilesystemIterator FilterIterator GlobIterator InfiniteIterator InvalidArgumentException IteratorIterator LengthException LimitIterator LogicException MultipleIterator NoRewindIterator OutOfBoundsException OutOfRangeException OuterIterator OverflowException ParentIterator ParseError RangeException RecursiveArrayIterator RecursiveCachingIterator RecursiveCallbackFilterIterator RecursiveDirectoryIterator RecursiveFilterIterator RecursiveIterator RecursiveIteratorIterator RecursiveRegexIterator RecursiveTreeIterator RegexIterator RuntimeException SeekableIterator SplDoublyLinkedList SplFileInfo SplFileObject SplFixedArray SplHeap SplMaxHeap SplMinHeap SplObjectStorage SplObserver SplObserver SplPriorityQueue SplQueue SplStack SplSubject SplSubject SplTempFileObject TypeError UnderflowException UnexpectedValueException ArrayAccess Closure Generator Iterator IteratorAggregate Serializable Throwable Traversable WeakReference Directory __PHP_Incomplete_Class parent php_user_filter self static stdClass"};return{aliases:["php","php3","php4","php5","php6","php7"],case_insensitive:!0,keywords:i,contains:[e.HASH_COMMENT_MODE,e.COMMENT("//","$",{contains:[t]}),e.COMMENT("/\\*","\\*/",{contains:[{className:"doctag",begin:"@[A-Za-z]+"}]}),e.COMMENT("__halt_compiler.+?;",!1,{endsWithParent:!0,keywords:"__halt_compiler"}),{className:"string",begin:/<<<['"]?\w+['"]?$/,end:/^\w+;?$/,contains:[e.BACKSLASH_ESCAPE,{className:"subst",variants:[{begin:/\$\w+/},{begin:/\{\$/,end:/\}/}]}]},t,{className:"keyword",begin:/\$this\b/},r,{begin:/(::|->)+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*/},{className:"function",beginKeywords:"fn function",end:/[;{]/,excludeEnd:!0,illegal:"[$%\\[]",contains:[e.UNDERSCORE_TITLE_MODE,{className:"params",begin:"\\(",end:"\\)",excludeBegin:!0,excludeEnd:!0,keywords:i,contains:["self",r,e.C_BLOCK_COMMENT_MODE,a,n]}]},{className:"class",beginKeywords:"class interface",end:"{",excludeEnd:!0,illegal:/[:\(\$"]/,contains:[{beginKeywords:"extends implements"},e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"namespace",end:";",illegal:/[\.']/,contains:[e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"use",end:";",contains:[e.UNDERSCORE_TITLE_MODE]},{begin:"=>"},a,n]}}}()); +hljs.registerLanguage("php-template",function(){"use strict";return function(n){return{name:"PHP template",subLanguage:"xml",contains:[{begin:/<\?(php|=)?/,end:/\?>/,subLanguage:"php",contains:[{begin:"/\\*",end:"\\*/",skip:!0},{begin:'b"',end:'"',skip:!0},{begin:"b'",end:"'",skip:!0},n.inherit(n.APOS_STRING_MODE,{illegal:null,className:null,contains:null,skip:!0}),n.inherit(n.QUOTE_STRING_MODE,{illegal:null,className:null,contains:null,skip:!0})]}]}}}()); +hljs.registerLanguage("plaintext",function(){"use strict";return function(t){return{name:"Plain text",aliases:["text","txt"],disableAutodetect:!0}}}()); +hljs.registerLanguage("properties",function(){"use strict";return function(e){var n="[ \\t\\f]*",t="("+n+"[:=]"+n+"|[ \\t\\f]+)",a="([^\\\\:= \\t\\f\\n]|\\\\.)+",s={end:t,relevance:0,starts:{className:"string",end:/$/,relevance:0,contains:[{begin:"\\\\\\n"}]}};return{name:".properties",case_insensitive:!0,illegal:/\S/,contains:[e.COMMENT("^\\s*[!#]","$"),{begin:"([^\\\\\\W:= \\t\\f\\n]|\\\\.)+"+t,returnBegin:!0,contains:[{className:"attr",begin:"([^\\\\\\W:= \\t\\f\\n]|\\\\.)+",endsParent:!0,relevance:0}],starts:s},{begin:a+t,returnBegin:!0,relevance:0,contains:[{className:"meta",begin:a,endsParent:!0,relevance:0}],starts:s},{className:"attr",relevance:0,begin:a+n+"$"}]}}}()); +hljs.registerLanguage("python",function(){"use strict";return function(e){var n={keyword:"and elif is global as in if from raise for except finally print import pass return exec else break not with class assert yield try while continue del or def lambda async await nonlocal|10",built_in:"Ellipsis NotImplemented",literal:"False None True"},a={className:"meta",begin:/^(>>>|\.\.\.) /},i={className:"subst",begin:/\{/,end:/\}/,keywords:n,illegal:/#/},s={begin:/\{\{/,relevance:0},r={className:"string",contains:[e.BACKSLASH_ESCAPE],variants:[{begin:/(u|b)?r?'''/,end:/'''/,contains:[e.BACKSLASH_ESCAPE,a],relevance:10},{begin:/(u|b)?r?"""/,end:/"""/,contains:[e.BACKSLASH_ESCAPE,a],relevance:10},{begin:/(fr|rf|f)'''/,end:/'''/,contains:[e.BACKSLASH_ESCAPE,a,s,i]},{begin:/(fr|rf|f)"""/,end:/"""/,contains:[e.BACKSLASH_ESCAPE,a,s,i]},{begin:/(u|r|ur)'/,end:/'/,relevance:10},{begin:/(u|r|ur)"/,end:/"/,relevance:10},{begin:/(b|br)'/,end:/'/},{begin:/(b|br)"/,end:/"/},{begin:/(fr|rf|f)'/,end:/'/,contains:[e.BACKSLASH_ESCAPE,s,i]},{begin:/(fr|rf|f)"/,end:/"/,contains:[e.BACKSLASH_ESCAPE,s,i]},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},l={className:"number",relevance:0,variants:[{begin:e.BINARY_NUMBER_RE+"[lLjJ]?"},{begin:"\\b(0o[0-7]+)[lLjJ]?"},{begin:e.C_NUMBER_RE+"[lLjJ]?"}]},t={className:"params",variants:[{begin:/\(\s*\)/,skip:!0,className:null},{begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,contains:["self",a,l,r,e.HASH_COMMENT_MODE]}]};return i.contains=[r,l,a],{name:"Python",aliases:["py","gyp","ipython"],keywords:n,illegal:/(<\/|->|\?)|=>/,contains:[a,l,{beginKeywords:"if",relevance:0},r,e.HASH_COMMENT_MODE,{variants:[{className:"function",beginKeywords:"def"},{className:"class",beginKeywords:"class"}],end:/:/,illegal:/[${=;\n,]/,contains:[e.UNDERSCORE_TITLE_MODE,t,{begin:/->/,endsWithParent:!0,keywords:"None"}]},{className:"meta",begin:/^[\t ]*@/,end:/$/},{begin:/\b(print|exec)\(/}]}}}()); +hljs.registerLanguage("python-repl",function(){"use strict";return function(n){return{aliases:["pycon"],contains:[{className:"meta",starts:{end:/ |$/,starts:{end:"$",subLanguage:"python"}},variants:[{begin:/^>>>(?=[ ]|$)/},{begin:/^\.\.\.(?=[ ]|$)/}]}]}}}()); +hljs.registerLanguage("ruby",function(){"use strict";return function(e){var n="[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?",a={keyword:"and then defined module in return redo if BEGIN retry end for self when next until do begin unless END rescue else break undef not super class case require yield alias while ensure elsif or include attr_reader attr_writer attr_accessor",literal:"true false nil"},s={className:"doctag",begin:"@[A-Za-z]+"},i={begin:"#<",end:">"},r=[e.COMMENT("#","$",{contains:[s]}),e.COMMENT("^\\=begin","^\\=end",{contains:[s],relevance:10}),e.COMMENT("^__END__","\\n$")],c={className:"subst",begin:"#\\{",end:"}",keywords:a},t={className:"string",contains:[e.BACKSLASH_ESCAPE,c],variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/`/,end:/`/},{begin:"%[qQwWx]?\\(",end:"\\)"},{begin:"%[qQwWx]?\\[",end:"\\]"},{begin:"%[qQwWx]?{",end:"}"},{begin:"%[qQwWx]?<",end:">"},{begin:"%[qQwWx]?/",end:"/"},{begin:"%[qQwWx]?%",end:"%"},{begin:"%[qQwWx]?-",end:"-"},{begin:"%[qQwWx]?\\|",end:"\\|"},{begin:/\B\?(\\\d{1,3}|\\x[A-Fa-f0-9]{1,2}|\\u[A-Fa-f0-9]{4}|\\?\S)\b/},{begin:/<<[-~]?'?(\w+)(?:.|\n)*?\n\s*\1\b/,returnBegin:!0,contains:[{begin:/<<[-~]?'?/},e.END_SAME_AS_BEGIN({begin:/(\w+)/,end:/(\w+)/,contains:[e.BACKSLASH_ESCAPE,c]})]}]},b={className:"params",begin:"\\(",end:"\\)",endsParent:!0,keywords:a},d=[t,i,{className:"class",beginKeywords:"class module",end:"$|;",illegal:/=/,contains:[e.inherit(e.TITLE_MODE,{begin:"[A-Za-z_]\\w*(::\\w+)*(\\?|\\!)?"}),{begin:"<\\s*",contains:[{begin:"("+e.IDENT_RE+"::)?"+e.IDENT_RE}]}].concat(r)},{className:"function",beginKeywords:"def",end:"$|;",contains:[e.inherit(e.TITLE_MODE,{begin:n}),b].concat(r)},{begin:e.IDENT_RE+"::"},{className:"symbol",begin:e.UNDERSCORE_IDENT_RE+"(\\!|\\?)?:",relevance:0},{className:"symbol",begin:":(?!\\s)",contains:[t,{begin:n}],relevance:0},{className:"number",begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",relevance:0},{begin:"(\\$\\W)|((\\$|\\@\\@?)(\\w+))"},{className:"params",begin:/\|/,end:/\|/,keywords:a},{begin:"("+e.RE_STARTERS_RE+"|unless)\\s*",keywords:"unless",contains:[i,{className:"regexp",contains:[e.BACKSLASH_ESCAPE,c],illegal:/\n/,variants:[{begin:"/",end:"/[a-z]*"},{begin:"%r{",end:"}[a-z]*"},{begin:"%r\\(",end:"\\)[a-z]*"},{begin:"%r!",end:"![a-z]*"},{begin:"%r\\[",end:"\\][a-z]*"}]}].concat(r),relevance:0}].concat(r);c.contains=d,b.contains=d;var g=[{begin:/^\s*=>/,starts:{end:"$",contains:d}},{className:"meta",begin:"^([>?]>|[\\w#]+\\(\\w+\\):\\d+:\\d+>|(\\w+-)?\\d+\\.\\d+\\.\\d(p\\d+)?[^>]+>)",starts:{end:"$",contains:d}}];return{name:"Ruby",aliases:["rb","gemspec","podspec","thor","irb"],keywords:a,illegal:/\/\*/,contains:r.concat(g).concat(d)}}}()); +hljs.registerLanguage("rust",function(){"use strict";return function(e){var n="([ui](8|16|32|64|128|size)|f(32|64))?",t="drop i8 i16 i32 i64 i128 isize u8 u16 u32 u64 u128 usize f32 f64 str char bool Box Option Result String Vec Copy Send Sized Sync Drop Fn FnMut FnOnce ToOwned Clone Debug PartialEq PartialOrd Eq Ord AsRef AsMut Into From Default Iterator Extend IntoIterator DoubleEndedIterator ExactSizeIterator SliceConcatExt ToString assert! assert_eq! bitflags! bytes! cfg! col! concat! concat_idents! debug_assert! debug_assert_eq! env! panic! file! format! format_args! include_bin! include_str! line! local_data_key! module_path! option_env! print! println! select! stringify! try! unimplemented! unreachable! vec! write! writeln! macro_rules! assert_ne! debug_assert_ne!";return{name:"Rust",aliases:["rs"],keywords:{$pattern:e.IDENT_RE+"!?",keyword:"abstract as async await become box break const continue crate do dyn else enum extern false final fn for if impl in let loop macro match mod move mut override priv pub ref return self Self static struct super trait true try type typeof unsafe unsized use virtual where while yield",literal:"true false Some None Ok Err",built_in:t},illegal:""}]}}}()); +hljs.registerLanguage("scss",function(){"use strict";return function(e){var t={className:"variable",begin:"(\\$[a-zA-Z-][a-zA-Z0-9_-]*)\\b"},i={className:"number",begin:"#[0-9A-Fa-f]+"};return e.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,e.C_BLOCK_COMMENT_MODE,{name:"SCSS",case_insensitive:!0,illegal:"[=/|']",contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{className:"selector-id",begin:"\\#[A-Za-z0-9_-]+",relevance:0},{className:"selector-class",begin:"\\.[A-Za-z0-9_-]+",relevance:0},{className:"selector-attr",begin:"\\[",end:"\\]",illegal:"$"},{className:"selector-tag",begin:"\\b(a|abbr|acronym|address|area|article|aside|audio|b|base|big|blockquote|body|br|button|canvas|caption|cite|code|col|colgroup|command|datalist|dd|del|details|dfn|div|dl|dt|em|embed|fieldset|figcaption|figure|footer|form|frame|frameset|(h[1-6])|head|header|hgroup|hr|html|i|iframe|img|input|ins|kbd|keygen|label|legend|li|link|map|mark|meta|meter|nav|noframes|noscript|object|ol|optgroup|option|output|p|param|pre|progress|q|rp|rt|ruby|samp|script|section|select|small|span|strike|strong|style|sub|sup|table|tbody|td|textarea|tfoot|th|thead|time|title|tr|tt|ul|var|video)\\b",relevance:0},{className:"selector-pseudo",begin:":(visited|valid|root|right|required|read-write|read-only|out-range|optional|only-of-type|only-child|nth-of-type|nth-last-of-type|nth-last-child|nth-child|not|link|left|last-of-type|last-child|lang|invalid|indeterminate|in-range|hover|focus|first-of-type|first-line|first-letter|first-child|first|enabled|empty|disabled|default|checked|before|after|active)"},{className:"selector-pseudo",begin:"::(after|before|choices|first-letter|first-line|repeat-index|repeat-item|selection|value)"},t,{className:"attribute",begin:"\\b(src|z-index|word-wrap|word-spacing|word-break|width|widows|white-space|visibility|vertical-align|unicode-bidi|transition-timing-function|transition-property|transition-duration|transition-delay|transition|transform-style|transform-origin|transform|top|text-underline-position|text-transform|text-shadow|text-rendering|text-overflow|text-indent|text-decoration-style|text-decoration-line|text-decoration-color|text-decoration|text-align-last|text-align|tab-size|table-layout|right|resize|quotes|position|pointer-events|perspective-origin|perspective|page-break-inside|page-break-before|page-break-after|padding-top|padding-right|padding-left|padding-bottom|padding|overflow-y|overflow-x|overflow-wrap|overflow|outline-width|outline-style|outline-offset|outline-color|outline|orphans|order|opacity|object-position|object-fit|normal|none|nav-up|nav-right|nav-left|nav-index|nav-down|min-width|min-height|max-width|max-height|mask|marks|margin-top|margin-right|margin-left|margin-bottom|margin|list-style-type|list-style-position|list-style-image|list-style|line-height|letter-spacing|left|justify-content|initial|inherit|ime-mode|image-orientation|image-resolution|image-rendering|icon|hyphens|height|font-weight|font-variant-ligatures|font-variant|font-style|font-stretch|font-size-adjust|font-size|font-language-override|font-kerning|font-feature-settings|font-family|font|float|flex-wrap|flex-shrink|flex-grow|flex-flow|flex-direction|flex-basis|flex|filter|empty-cells|display|direction|cursor|counter-reset|counter-increment|content|column-width|column-span|column-rule-width|column-rule-style|column-rule-color|column-rule|column-gap|column-fill|column-count|columns|color|clip-path|clip|clear|caption-side|break-inside|break-before|break-after|box-sizing|box-shadow|box-decoration-break|bottom|border-width|border-top-width|border-top-style|border-top-right-radius|border-top-left-radius|border-top-color|border-top|border-style|border-spacing|border-right-width|border-right-style|border-right-color|border-right|border-radius|border-left-width|border-left-style|border-left-color|border-left|border-image-width|border-image-source|border-image-slice|border-image-repeat|border-image-outset|border-image|border-color|border-collapse|border-bottom-width|border-bottom-style|border-bottom-right-radius|border-bottom-left-radius|border-bottom-color|border-bottom|border|background-size|background-repeat|background-position|background-origin|background-image|background-color|background-clip|background-attachment|background-blend-mode|background|backface-visibility|auto|animation-timing-function|animation-play-state|animation-name|animation-iteration-count|animation-fill-mode|animation-duration|animation-direction|animation-delay|animation|align-self|align-items|align-content)\\b",illegal:"[^\\s]"},{begin:"\\b(whitespace|wait|w-resize|visible|vertical-text|vertical-ideographic|uppercase|upper-roman|upper-alpha|underline|transparent|top|thin|thick|text|text-top|text-bottom|tb-rl|table-header-group|table-footer-group|sw-resize|super|strict|static|square|solid|small-caps|separate|se-resize|scroll|s-resize|rtl|row-resize|ridge|right|repeat|repeat-y|repeat-x|relative|progress|pointer|overline|outside|outset|oblique|nowrap|not-allowed|normal|none|nw-resize|no-repeat|no-drop|newspaper|ne-resize|n-resize|move|middle|medium|ltr|lr-tb|lowercase|lower-roman|lower-alpha|loose|list-item|line|line-through|line-edge|lighter|left|keep-all|justify|italic|inter-word|inter-ideograph|inside|inset|inline|inline-block|inherit|inactive|ideograph-space|ideograph-parenthesis|ideograph-numeric|ideograph-alpha|horizontal|hidden|help|hand|groove|fixed|ellipsis|e-resize|double|dotted|distribute|distribute-space|distribute-letter|distribute-all-lines|disc|disabled|default|decimal|dashed|crosshair|collapse|col-resize|circle|char|center|capitalize|break-word|break-all|bottom|both|bolder|bold|block|bidi-override|below|baseline|auto|always|all-scroll|absolute|table|table-cell)\\b"},{begin:":",end:";",contains:[t,i,e.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,{className:"meta",begin:"!important"}]},{begin:"@(page|font-face)",lexemes:"@[a-z-]+",keywords:"@page @font-face"},{begin:"@",end:"[{;]",returnBegin:!0,keywords:"and or not only",contains:[{begin:"@[a-z-]+",className:"keyword"},t,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,i,e.CSS_NUMBER_MODE]}]}}}()); +hljs.registerLanguage("shell",function(){"use strict";return function(s){return{name:"Shell Session",aliases:["console"],contains:[{className:"meta",begin:"^\\s{0,3}[/\\w\\d\\[\\]()@-]*[>%$#]",starts:{end:"$",subLanguage:"bash"}}]}}}()); +hljs.registerLanguage("sql",function(){"use strict";return function(e){var t=e.COMMENT("--","$");return{name:"SQL",case_insensitive:!0,illegal:/[<>{}*]/,contains:[{beginKeywords:"begin end start commit rollback savepoint lock alter create drop rename call delete do handler insert load replace select truncate update set show pragma grant merge describe use explain help declare prepare execute deallocate release unlock purge reset change stop analyze cache flush optimize repair kill install uninstall checksum restore check backup revoke comment values with",end:/;/,endsWithParent:!0,keywords:{$pattern:/[\w\.]+/,keyword:"as abort abs absolute acc acce accep accept access accessed accessible account acos action activate add addtime admin administer advanced advise aes_decrypt aes_encrypt after agent aggregate ali alia alias all allocate allow alter always analyze ancillary and anti any anydata anydataset anyschema anytype apply archive archived archivelog are as asc ascii asin assembly assertion associate asynchronous at atan atn2 attr attri attrib attribu attribut attribute attributes audit authenticated authentication authid authors auto autoallocate autodblink autoextend automatic availability avg backup badfile basicfile before begin beginning benchmark between bfile bfile_base big bigfile bin binary_double binary_float binlog bit_and bit_count bit_length bit_or bit_xor bitmap blob_base block blocksize body both bound bucket buffer_cache buffer_pool build bulk by byte byteordermark bytes cache caching call calling cancel capacity cascade cascaded case cast catalog category ceil ceiling chain change changed char_base char_length character_length characters characterset charindex charset charsetform charsetid check checksum checksum_agg child choose chr chunk class cleanup clear client clob clob_base clone close cluster_id cluster_probability cluster_set clustering coalesce coercibility col collate collation collect colu colum column column_value columns columns_updated comment commit compact compatibility compiled complete composite_limit compound compress compute concat concat_ws concurrent confirm conn connec connect connect_by_iscycle connect_by_isleaf connect_by_root connect_time connection consider consistent constant constraint constraints constructor container content contents context contributors controlfile conv convert convert_tz corr corr_k corr_s corresponding corruption cos cost count count_big counted covar_pop covar_samp cpu_per_call cpu_per_session crc32 create creation critical cross cube cume_dist curdate current current_date current_time current_timestamp current_user cursor curtime customdatum cycle data database databases datafile datafiles datalength date_add date_cache date_format date_sub dateadd datediff datefromparts datename datepart datetime2fromparts day day_to_second dayname dayofmonth dayofweek dayofyear days db_role_change dbtimezone ddl deallocate declare decode decompose decrement decrypt deduplicate def defa defau defaul default defaults deferred defi defin define degrees delayed delegate delete delete_all delimited demand dense_rank depth dequeue des_decrypt des_encrypt des_key_file desc descr descri describ describe descriptor deterministic diagnostics difference dimension direct_load directory disable disable_all disallow disassociate discardfile disconnect diskgroup distinct distinctrow distribute distributed div do document domain dotnet double downgrade drop dumpfile duplicate duration each edition editionable editions element ellipsis else elsif elt empty enable enable_all enclosed encode encoding encrypt end end-exec endian enforced engine engines enqueue enterprise entityescaping eomonth error errors escaped evalname evaluate event eventdata events except exception exceptions exchange exclude excluding execu execut execute exempt exists exit exp expire explain explode export export_set extended extent external external_1 external_2 externally extract failed failed_login_attempts failover failure far fast feature_set feature_value fetch field fields file file_name_convert filesystem_like_logging final finish first first_value fixed flash_cache flashback floor flush following follows for forall force foreign form forma format found found_rows freelist freelists freepools fresh from from_base64 from_days ftp full function general generated get get_format get_lock getdate getutcdate global global_name globally go goto grant grants greatest group group_concat group_id grouping grouping_id groups gtid_subtract guarantee guard handler hash hashkeys having hea head headi headin heading heap help hex hierarchy high high_priority hosts hour hours http id ident_current ident_incr ident_seed identified identity idle_time if ifnull ignore iif ilike ilm immediate import in include including increment index indexes indexing indextype indicator indices inet6_aton inet6_ntoa inet_aton inet_ntoa infile initial initialized initially initrans inmemory inner innodb input insert install instance instantiable instr interface interleaved intersect into invalidate invisible is is_free_lock is_ipv4 is_ipv4_compat is_not is_not_null is_used_lock isdate isnull isolation iterate java join json json_exists keep keep_duplicates key keys kill language large last last_day last_insert_id last_value lateral lax lcase lead leading least leaves left len lenght length less level levels library like like2 like4 likec limit lines link list listagg little ln load load_file lob lobs local localtime localtimestamp locate locator lock locked log log10 log2 logfile logfiles logging logical logical_reads_per_call logoff logon logs long loop low low_priority lower lpad lrtrim ltrim main make_set makedate maketime managed management manual map mapping mask master master_pos_wait match matched materialized max maxextents maximize maxinstances maxlen maxlogfiles maxloghistory maxlogmembers maxsize maxtrans md5 measures median medium member memcompress memory merge microsecond mid migration min minextents minimum mining minus minute minutes minvalue missing mod mode model modification modify module monitoring month months mount move movement multiset mutex name name_const names nan national native natural nav nchar nclob nested never new newline next nextval no no_write_to_binlog noarchivelog noaudit nobadfile nocheck nocompress nocopy nocycle nodelay nodiscardfile noentityescaping noguarantee nokeep nologfile nomapping nomaxvalue nominimize nominvalue nomonitoring none noneditionable nonschema noorder nopr nopro noprom nopromp noprompt norely noresetlogs noreverse normal norowdependencies noschemacheck noswitch not nothing notice notnull notrim novalidate now nowait nth_value nullif nulls num numb numbe nvarchar nvarchar2 object ocicoll ocidate ocidatetime ociduration ociinterval ociloblocator ocinumber ociref ocirefcursor ocirowid ocistring ocitype oct octet_length of off offline offset oid oidindex old on online only opaque open operations operator optimal optimize option optionally or oracle oracle_date oradata ord ordaudio orddicom orddoc order ordimage ordinality ordvideo organization orlany orlvary out outer outfile outline output over overflow overriding package pad parallel parallel_enable parameters parent parse partial partition partitions pascal passing password password_grace_time password_lock_time password_reuse_max password_reuse_time password_verify_function patch path patindex pctincrease pctthreshold pctused pctversion percent percent_rank percentile_cont percentile_disc performance period period_add period_diff permanent physical pi pipe pipelined pivot pluggable plugin policy position post_transaction pow power pragma prebuilt precedes preceding precision prediction prediction_cost prediction_details prediction_probability prediction_set prepare present preserve prior priority private private_sga privileges procedural procedure procedure_analyze processlist profiles project prompt protection public publishingservername purge quarter query quick quiesce quota quotename radians raise rand range rank raw read reads readsize rebuild record records recover recovery recursive recycle redo reduced ref reference referenced references referencing refresh regexp_like register regr_avgx regr_avgy regr_count regr_intercept regr_r2 regr_slope regr_sxx regr_sxy reject rekey relational relative relaylog release release_lock relies_on relocate rely rem remainder rename repair repeat replace replicate replication required reset resetlogs resize resource respect restore restricted result result_cache resumable resume retention return returning returns reuse reverse revoke right rlike role roles rollback rolling rollup round row row_count rowdependencies rowid rownum rows rtrim rules safe salt sample save savepoint sb1 sb2 sb4 scan schema schemacheck scn scope scroll sdo_georaster sdo_topo_geometry search sec_to_time second seconds section securefile security seed segment select self semi sequence sequential serializable server servererror session session_user sessions_per_user set sets settings sha sha1 sha2 share shared shared_pool short show shrink shutdown si_averagecolor si_colorhistogram si_featurelist si_positionalcolor si_stillimage si_texture siblings sid sign sin size size_t sizes skip slave sleep smalldatetimefromparts smallfile snapshot some soname sort soundex source space sparse spfile split sql sql_big_result sql_buffer_result sql_cache sql_calc_found_rows sql_small_result sql_variant_property sqlcode sqldata sqlerror sqlname sqlstate sqrt square standalone standby start starting startup statement static statistics stats_binomial_test stats_crosstab stats_ks_test stats_mode stats_mw_test stats_one_way_anova stats_t_test_ stats_t_test_indep stats_t_test_one stats_t_test_paired stats_wsr_test status std stddev stddev_pop stddev_samp stdev stop storage store stored str str_to_date straight_join strcmp strict string struct stuff style subdate subpartition subpartitions substitutable substr substring subtime subtring_index subtype success sum suspend switch switchoffset switchover sync synchronous synonym sys sys_xmlagg sysasm sysaux sysdate sysdatetimeoffset sysdba sysoper system system_user sysutcdatetime table tables tablespace tablesample tan tdo template temporary terminated tertiary_weights test than then thread through tier ties time time_format time_zone timediff timefromparts timeout timestamp timestampadd timestampdiff timezone_abbr timezone_minute timezone_region to to_base64 to_date to_days to_seconds todatetimeoffset trace tracking transaction transactional translate translation treat trigger trigger_nestlevel triggers trim truncate try_cast try_convert try_parse type ub1 ub2 ub4 ucase unarchived unbounded uncompress under undo unhex unicode uniform uninstall union unique unix_timestamp unknown unlimited unlock unnest unpivot unrecoverable unsafe unsigned until untrusted unusable unused update updated upgrade upped upper upsert url urowid usable usage use use_stored_outlines user user_data user_resources users using utc_date utc_timestamp uuid uuid_short validate validate_password_strength validation valist value values var var_samp varcharc vari varia variab variabl variable variables variance varp varraw varrawc varray verify version versions view virtual visible void wait wallet warning warnings week weekday weekofyear wellformed when whene whenev wheneve whenever where while whitespace window with within without work wrapped xdb xml xmlagg xmlattributes xmlcast xmlcolattval xmlelement xmlexists xmlforest xmlindex xmlnamespaces xmlpi xmlquery xmlroot xmlschema xmlserialize xmltable xmltype xor year year_to_month years yearweek",literal:"true false null unknown",built_in:"array bigint binary bit blob bool boolean char character date dec decimal float int int8 integer interval number numeric real record serial serial8 smallint text time timestamp tinyint varchar varchar2 varying void"},contains:[{className:"string",begin:"'",end:"'",contains:[{begin:"''"}]},{className:"string",begin:'"',end:'"',contains:[{begin:'""'}]},{className:"string",begin:"`",end:"`"},e.C_NUMBER_MODE,e.C_BLOCK_COMMENT_MODE,t,e.HASH_COMMENT_MODE]},e.C_BLOCK_COMMENT_MODE,t,e.HASH_COMMENT_MODE]}}}()); +hljs.registerLanguage("swift",function(){"use strict";return function(e){var i={keyword:"#available #colorLiteral #column #else #elseif #endif #file #fileLiteral #function #if #imageLiteral #line #selector #sourceLocation _ __COLUMN__ __FILE__ __FUNCTION__ __LINE__ Any as as! as? associatedtype associativity break case catch class continue convenience default defer deinit didSet do dynamic dynamicType else enum extension fallthrough false fileprivate final for func get guard if import in indirect infix init inout internal is lazy left let mutating nil none nonmutating open operator optional override postfix precedence prefix private protocol Protocol public repeat required rethrows return right self Self set static struct subscript super switch throw throws true try try! try? Type typealias unowned var weak where while willSet",literal:"true false nil",built_in:"abs advance alignof alignofValue anyGenerator assert assertionFailure bridgeFromObjectiveC bridgeFromObjectiveCUnconditional bridgeToObjectiveC bridgeToObjectiveCUnconditional c compactMap contains count countElements countLeadingZeros debugPrint debugPrintln distance dropFirst dropLast dump encodeBitsAsWords enumerate equal fatalError filter find getBridgedObjectiveCType getVaList indices insertionSort isBridgedToObjectiveC isBridgedVerbatimToObjectiveC isUniquelyReferenced isUniquelyReferencedNonObjC join lazy lexicographicalCompare map max maxElement min minElement numericCast overlaps partition posix precondition preconditionFailure print println quickSort readLine reduce reflect reinterpretCast reverse roundUpToAlignment sizeof sizeofValue sort split startsWith stride strideof strideofValue swap toString transcode underestimateCount unsafeAddressOf unsafeBitCast unsafeDowncast unsafeUnwrap unsafeReflect withExtendedLifetime withObjectAtPlusZero withUnsafePointer withUnsafePointerToObject withUnsafeMutablePointer withUnsafeMutablePointers withUnsafePointer withUnsafePointers withVaList zip"},n=e.COMMENT("/\\*","\\*/",{contains:["self"]}),t={className:"subst",begin:/\\\(/,end:"\\)",keywords:i,contains:[]},a={className:"string",contains:[e.BACKSLASH_ESCAPE,t],variants:[{begin:/"""/,end:/"""/},{begin:/"/,end:/"/}]},r={className:"number",begin:"\\b([\\d_]+(\\.[\\deE_]+)?|0x[a-fA-F0-9_]+(\\.[a-fA-F0-9p_]+)?|0b[01_]+|0o[0-7_]+)\\b",relevance:0};return t.contains=[r],{name:"Swift",keywords:i,contains:[a,e.C_LINE_COMMENT_MODE,n,{className:"type",begin:"\\b[A-Z][\\wร€-สธ']*[!?]"},{className:"type",begin:"\\b[A-Z][\\wร€-สธ']*",relevance:0},r,{className:"function",beginKeywords:"func",end:"{",excludeEnd:!0,contains:[e.inherit(e.TITLE_MODE,{begin:/[A-Za-z$_][0-9A-Za-z$_]*/}),{begin://},{className:"params",begin:/\(/,end:/\)/,endsParent:!0,keywords:i,contains:["self",r,a,e.C_BLOCK_COMMENT_MODE,{begin:":"}],illegal:/["']/}],illegal:/\[|%/},{className:"class",beginKeywords:"struct protocol class extension enum",keywords:i,end:"\\{",excludeEnd:!0,contains:[e.inherit(e.TITLE_MODE,{begin:/[A-Za-z$_][\u00C0-\u02B80-9A-Za-z$_]*/})]},{className:"meta",begin:"(@discardableResult|@warn_unused_result|@exported|@lazy|@noescape|@NSCopying|@NSManaged|@objc|@objcMembers|@convention|@required|@noreturn|@IBAction|@IBDesignable|@IBInspectable|@IBOutlet|@infix|@prefix|@postfix|@autoclosure|@testable|@available|@nonobjc|@NSApplicationMain|@UIApplicationMain|@dynamicMemberLookup|@propertyWrapper)\\b"},{beginKeywords:"import",end:/$/,contains:[e.C_LINE_COMMENT_MODE,n]}]}}}()); +hljs.registerLanguage("typescript",function(){"use strict";const e=["as","in","of","if","for","while","finally","var","new","function","do","return","void","else","break","catch","instanceof","with","throw","case","default","try","switch","continue","typeof","delete","let","yield","const","class","debugger","async","await","static","import","from","export","extends"],n=["true","false","null","undefined","NaN","Infinity"],a=[].concat(["setInterval","setTimeout","clearInterval","clearTimeout","require","exports","eval","isFinite","isNaN","parseFloat","parseInt","decodeURI","decodeURIComponent","encodeURI","encodeURIComponent","escape","unescape"],["arguments","this","super","console","window","document","localStorage","module","global"],["Intl","DataView","Number","Math","Date","String","RegExp","Object","Function","Boolean","Error","Symbol","Set","Map","WeakSet","WeakMap","Proxy","Reflect","JSON","Promise","Float64Array","Int16Array","Int32Array","Int8Array","Uint16Array","Uint32Array","Float32Array","Array","Uint8Array","Uint8ClampedArray","ArrayBuffer"],["EvalError","InternalError","RangeError","ReferenceError","SyntaxError","TypeError","URIError"]);return function(r){var t={$pattern:"[A-Za-z$_][0-9A-Za-z$_]*",keyword:e.concat(["type","namespace","typedef","interface","public","private","protected","implements","declare","abstract","readonly"]).join(" "),literal:n.join(" "),built_in:a.concat(["any","void","number","boolean","string","object","never","enum"]).join(" ")},s={className:"meta",begin:"@[A-Za-z$_][0-9A-Za-z$_]*"},i={className:"number",variants:[{begin:"\\b(0[bB][01]+)n?"},{begin:"\\b(0[oO][0-7]+)n?"},{begin:r.C_NUMBER_RE+"n?"}],relevance:0},o={className:"subst",begin:"\\$\\{",end:"\\}",keywords:t,contains:[]},c={begin:"html`",end:"",starts:{end:"`",returnEnd:!1,contains:[r.BACKSLASH_ESCAPE,o],subLanguage:"xml"}},l={begin:"css`",end:"",starts:{end:"`",returnEnd:!1,contains:[r.BACKSLASH_ESCAPE,o],subLanguage:"css"}},E={className:"string",begin:"`",end:"`",contains:[r.BACKSLASH_ESCAPE,o]};o.contains=[r.APOS_STRING_MODE,r.QUOTE_STRING_MODE,c,l,E,i,r.REGEXP_MODE];var d={begin:"\\(",end:/\)/,keywords:t,contains:["self",r.QUOTE_STRING_MODE,r.APOS_STRING_MODE,r.NUMBER_MODE]},u={className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:t,contains:[r.C_LINE_COMMENT_MODE,r.C_BLOCK_COMMENT_MODE,s,d]};return{name:"TypeScript",aliases:["ts"],keywords:t,contains:[r.SHEBANG(),{className:"meta",begin:/^\s*['"]use strict['"]/},r.APOS_STRING_MODE,r.QUOTE_STRING_MODE,c,l,E,r.C_LINE_COMMENT_MODE,r.C_BLOCK_COMMENT_MODE,i,{begin:"("+r.RE_STARTERS_RE+"|\\b(case|return|throw)\\b)\\s*",keywords:"return throw case",contains:[r.C_LINE_COMMENT_MODE,r.C_BLOCK_COMMENT_MODE,r.REGEXP_MODE,{className:"function",begin:"(\\([^(]*(\\([^(]*(\\([^(]*\\))?\\))?\\)|"+r.UNDERSCORE_IDENT_RE+")\\s*=>",returnBegin:!0,end:"\\s*=>",contains:[{className:"params",variants:[{begin:r.UNDERSCORE_IDENT_RE},{className:null,begin:/\(\s*\)/,skip:!0},{begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:t,contains:d.contains}]}]}],relevance:0},{className:"function",beginKeywords:"function",end:/[\{;]/,excludeEnd:!0,keywords:t,contains:["self",r.inherit(r.TITLE_MODE,{begin:"[A-Za-z$_][0-9A-Za-z$_]*"}),u],illegal:/%/,relevance:0},{beginKeywords:"constructor",end:/[\{;]/,excludeEnd:!0,contains:["self",u]},{begin:/module\./,keywords:{built_in:"module"},relevance:0},{beginKeywords:"module",end:/\{/,excludeEnd:!0},{beginKeywords:"interface",end:/\{/,excludeEnd:!0,keywords:"interface extends"},{begin:/\$[(.]/},{begin:"\\."+r.IDENT_RE,relevance:0},s,d]}}}()); +hljs.registerLanguage("yaml",function(){"use strict";return function(e){var n="true false yes no null",a="[\\w#;/?:@&=+$,.~*\\'()[\\]]+",s={className:"string",relevance:0,variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/\S+/}],contains:[e.BACKSLASH_ESCAPE,{className:"template-variable",variants:[{begin:"{{",end:"}}"},{begin:"%{",end:"}"}]}]},i=e.inherit(s,{variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/[^\s,{}[\]]+/}]}),l={end:",",endsWithParent:!0,excludeEnd:!0,contains:[],keywords:n,relevance:0},t={begin:"{",end:"}",contains:[l],illegal:"\\n",relevance:0},g={begin:"\\[",end:"\\]",contains:[l],illegal:"\\n",relevance:0},b=[{className:"attr",variants:[{begin:"\\w[\\w :\\/.-]*:(?=[ \t]|$)"},{begin:'"\\w[\\w :\\/.-]*":(?=[ \t]|$)'},{begin:"'\\w[\\w :\\/.-]*':(?=[ \t]|$)"}]},{className:"meta",begin:"^---s*$",relevance:10},{className:"string",begin:"[\\|>]([0-9]?[+-])?[ ]*\\n( *)[\\S ]+\\n(\\2[\\S ]+\\n?)*"},{begin:"<%[%=-]?",end:"[%-]?%>",subLanguage:"ruby",excludeBegin:!0,excludeEnd:!0,relevance:0},{className:"type",begin:"!\\w+!"+a},{className:"type",begin:"!<"+a+">"},{className:"type",begin:"!"+a},{className:"type",begin:"!!"+a},{className:"meta",begin:"&"+e.UNDERSCORE_IDENT_RE+"$"},{className:"meta",begin:"\\*"+e.UNDERSCORE_IDENT_RE+"$"},{className:"bullet",begin:"\\-(?=[ ]|$)",relevance:0},e.HASH_COMMENT_MODE,{beginKeywords:n,keywords:{literal:n}},{className:"number",begin:"\\b[0-9]{4}(-[0-9][0-9]){0,2}([Tt \\t][0-9][0-9]?(:[0-9][0-9]){2})?(\\.[0-9]*)?([ \\t])*(Z|[-+][0-9][0-9]?(:[0-9][0-9])?)?\\b"},{className:"number",begin:e.C_NUMBER_RE+"\\b"},t,g,s],c=[...b];return c.pop(),c.push(i),l.contains=c,{name:"YAML",case_insensitive:!0,aliases:["yml","YAML"],contains:b}}}()); +hljs.registerLanguage("armasm",function(){"use strict";return function(s){const e={variants:[s.COMMENT("^[ \\t]*(?=#)","$",{relevance:0,excludeBegin:!0}),s.COMMENT("[;@]","$",{relevance:0}),s.C_LINE_COMMENT_MODE,s.C_BLOCK_COMMENT_MODE]};return{name:"ARM Assembly",case_insensitive:!0,aliases:["arm"],keywords:{$pattern:"\\.?"+s.IDENT_RE,meta:".2byte .4byte .align .ascii .asciz .balign .byte .code .data .else .end .endif .endm .endr .equ .err .exitm .extern .global .hword .if .ifdef .ifndef .include .irp .long .macro .rept .req .section .set .skip .space .text .word .arm .thumb .code16 .code32 .force_thumb .thumb_func .ltorg ALIAS ALIGN ARM AREA ASSERT ATTR CN CODE CODE16 CODE32 COMMON CP DATA DCB DCD DCDU DCDO DCFD DCFDU DCI DCQ DCQU DCW DCWU DN ELIF ELSE END ENDFUNC ENDIF ENDP ENTRY EQU EXPORT EXPORTAS EXTERN FIELD FILL FUNCTION GBLA GBLL GBLS GET GLOBAL IF IMPORT INCBIN INCLUDE INFO KEEP LCLA LCLL LCLS LTORG MACRO MAP MEND MEXIT NOFP OPT PRESERVE8 PROC QN READONLY RELOC REQUIRE REQUIRE8 RLIST FN ROUT SETA SETL SETS SN SPACE SUBT THUMB THUMBX TTL WHILE WEND ",built_in:"r0 r1 r2 r3 r4 r5 r6 r7 r8 r9 r10 r11 r12 r13 r14 r15 pc lr sp ip sl sb fp a1 a2 a3 a4 v1 v2 v3 v4 v5 v6 v7 v8 f0 f1 f2 f3 f4 f5 f6 f7 p0 p1 p2 p3 p4 p5 p6 p7 p8 p9 p10 p11 p12 p13 p14 p15 c0 c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 c15 q0 q1 q2 q3 q4 q5 q6 q7 q8 q9 q10 q11 q12 q13 q14 q15 cpsr_c cpsr_x cpsr_s cpsr_f cpsr_cx cpsr_cxs cpsr_xs cpsr_xsf cpsr_sf cpsr_cxsf spsr_c spsr_x spsr_s spsr_f spsr_cx spsr_cxs spsr_xs spsr_xsf spsr_sf spsr_cxsf s0 s1 s2 s3 s4 s5 s6 s7 s8 s9 s10 s11 s12 s13 s14 s15 s16 s17 s18 s19 s20 s21 s22 s23 s24 s25 s26 s27 s28 s29 s30 s31 d0 d1 d2 d3 d4 d5 d6 d7 d8 d9 d10 d11 d12 d13 d14 d15 d16 d17 d18 d19 d20 d21 d22 d23 d24 d25 d26 d27 d28 d29 d30 d31 {PC} {VAR} {TRUE} {FALSE} {OPT} {CONFIG} {ENDIAN} {CODESIZE} {CPU} {FPU} {ARCHITECTURE} {PCSTOREOFFSET} {ARMASM_VERSION} {INTER} {ROPI} {RWPI} {SWST} {NOSWST} . @"},contains:[{className:"keyword",begin:"\\b(adc|(qd?|sh?|u[qh]?)?add(8|16)?|usada?8|(q|sh?|u[qh]?)?(as|sa)x|and|adrl?|sbc|rs[bc]|asr|b[lx]?|blx|bxj|cbn?z|tb[bh]|bic|bfc|bfi|[su]bfx|bkpt|cdp2?|clz|clrex|cmp|cmn|cpsi[ed]|cps|setend|dbg|dmb|dsb|eor|isb|it[te]{0,3}|lsl|lsr|ror|rrx|ldm(([id][ab])|f[ds])?|ldr((s|ex)?[bhd])?|movt?|mvn|mra|mar|mul|[us]mull|smul[bwt][bt]|smu[as]d|smmul|smmla|mla|umlaal|smlal?([wbt][bt]|d)|mls|smlsl?[ds]|smc|svc|sev|mia([bt]{2}|ph)?|mrr?c2?|mcrr2?|mrs|msr|orr|orn|pkh(tb|bt)|rbit|rev(16|sh)?|sel|[su]sat(16)?|nop|pop|push|rfe([id][ab])?|stm([id][ab])?|str(ex)?[bhd]?|(qd?)?sub|(sh?|q|u[qh]?)?sub(8|16)|[su]xt(a?h|a?b(16)?)|srs([id][ab])?|swpb?|swi|smi|tst|teq|wfe|wfi|yield)(eq|ne|cs|cc|mi|pl|vs|vc|hi|ls|ge|lt|gt|le|al|hs|lo)?[sptrx]?(?=\\s)"},e,s.QUOTE_STRING_MODE,{className:"string",begin:"'",end:"[^\\\\]'",relevance:0},{className:"title",begin:"\\|",end:"\\|",illegal:"\\n",relevance:0},{className:"number",variants:[{begin:"[#$=]?0x[0-9a-f]+"},{begin:"[#$=]?0b[01]+"},{begin:"[#$=]\\d+"},{begin:"\\b\\d+"}],relevance:0},{className:"symbol",variants:[{begin:"^[ \\t]*[a-z_\\.\\$][a-z0-9_\\.\\$]+:"},{begin:"^[a-z_\\.\\$][a-z0-9_\\.\\$]+"},{begin:"[=#]\\w+"}],relevance:0}]}}}()); +hljs.registerLanguage("d",function(){"use strict";return function(e){var a={$pattern:e.UNDERSCORE_IDENT_RE,keyword:"abstract alias align asm assert auto body break byte case cast catch class const continue debug default delete deprecated do else enum export extern final finally for foreach foreach_reverse|10 goto if immutable import in inout int interface invariant is lazy macro mixin module new nothrow out override package pragma private protected public pure ref return scope shared static struct super switch synchronized template this throw try typedef typeid typeof union unittest version void volatile while with __FILE__ __LINE__ __gshared|10 __thread __traits __DATE__ __EOF__ __TIME__ __TIMESTAMP__ __VENDOR__ __VERSION__",built_in:"bool cdouble cent cfloat char creal dchar delegate double dstring float function idouble ifloat ireal long real short string ubyte ucent uint ulong ushort wchar wstring",literal:"false null true"},d="((0|[1-9][\\d_]*)|0[bB][01_]+|0[xX]([\\da-fA-F][\\da-fA-F_]*|_[\\da-fA-F][\\da-fA-F_]*))",n="\\\\(['\"\\?\\\\abfnrtv]|u[\\dA-Fa-f]{4}|[0-7]{1,3}|x[\\dA-Fa-f]{2}|U[\\dA-Fa-f]{8})|&[a-zA-Z\\d]{2,};",t={className:"number",begin:"\\b"+d+"(L|u|U|Lu|LU|uL|UL)?",relevance:0},_={className:"number",begin:"\\b(((0[xX](([\\da-fA-F][\\da-fA-F_]*|_[\\da-fA-F][\\da-fA-F_]*)\\.([\\da-fA-F][\\da-fA-F_]*|_[\\da-fA-F][\\da-fA-F_]*)|\\.?([\\da-fA-F][\\da-fA-F_]*|_[\\da-fA-F][\\da-fA-F_]*))[pP][+-]?(0|[1-9][\\d_]*|\\d[\\d_]*|[\\d_]+?\\d))|((0|[1-9][\\d_]*|\\d[\\d_]*|[\\d_]+?\\d)(\\.\\d*|([eE][+-]?(0|[1-9][\\d_]*|\\d[\\d_]*|[\\d_]+?\\d)))|\\d+\\.(0|[1-9][\\d_]*|\\d[\\d_]*|[\\d_]+?\\d)(0|[1-9][\\d_]*|\\d[\\d_]*|[\\d_]+?\\d)|\\.(0|[1-9][\\d_]*)([eE][+-]?(0|[1-9][\\d_]*|\\d[\\d_]*|[\\d_]+?\\d))?))([fF]|L|i|[fF]i|Li)?|"+d+"(i|[fF]i|Li))",relevance:0},r={className:"string",begin:"'("+n+"|.)",end:"'",illegal:"."},i={className:"string",begin:'"',contains:[{begin:n,relevance:0}],end:'"[cwd]?'},s=e.COMMENT("\\/\\+","\\+\\/",{contains:["self"],relevance:10});return{name:"D",keywords:a,contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,s,{className:"string",begin:'x"[\\da-fA-F\\s\\n\\r]*"[cwd]?',relevance:10},i,{className:"string",begin:'[rq]"',end:'"[cwd]?',relevance:5},{className:"string",begin:"`",end:"`[cwd]?"},{className:"string",begin:'q"\\{',end:'\\}"'},_,t,r,{className:"meta",begin:"^#!",end:"$",relevance:5},{className:"meta",begin:"#(line)",end:"$",relevance:5},{className:"keyword",begin:"@[a-zA-Z_][a-zA-Z_\\d]*"}]}}}()); +hljs.registerLanguage("handlebars",function(){"use strict";function e(...e){return e.map(e=>(function(e){return e?"string"==typeof e?e:e.source:null})(e)).join("")}return function(n){const a={"builtin-name":"action bindattr collection component concat debugger each each-in get hash if in input link-to loc log lookup mut outlet partial query-params render template textarea unbound unless view with yield"},t=/\[.*?\]/,s=/[^\s!"#%&'()*+,.\/;<=>@\[\\\]^`{|}~]+/,i=e("(",/'.*?'/,"|",/".*?"/,"|",t,"|",s,"|",/\.|\//,")+"),r=e("(",t,"|",s,")(?==)"),l={begin:i,lexemes:/[\w.\/]+/},c=n.inherit(l,{keywords:{literal:"true false undefined null"}}),o={begin:/\(/,end:/\)/},m={className:"attr",begin:r,relevance:0,starts:{begin:/=/,end:/=/,starts:{contains:[n.NUMBER_MODE,n.QUOTE_STRING_MODE,n.APOS_STRING_MODE,c,o]}}},d={contains:[n.NUMBER_MODE,n.QUOTE_STRING_MODE,n.APOS_STRING_MODE,{begin:/as\s+\|/,keywords:{keyword:"as"},end:/\|/,contains:[{begin:/\w+/}]},m,c,o],returnEnd:!0},g=n.inherit(l,{className:"name",keywords:a,starts:n.inherit(d,{end:/\)/})});o.contains=[g];const u=n.inherit(l,{keywords:a,className:"name",starts:n.inherit(d,{end:/}}/})}),b=n.inherit(l,{keywords:a,className:"name"}),h=n.inherit(l,{className:"name",keywords:a,starts:n.inherit(d,{end:/}}/})});return{name:"Handlebars",aliases:["hbs","html.hbs","html.handlebars","htmlbars"],case_insensitive:!0,subLanguage:"xml",contains:[{begin:/\\\{\{/,skip:!0},{begin:/\\\\(?=\{\{)/,skip:!0},n.COMMENT(/\{\{!--/,/--\}\}/),n.COMMENT(/\{\{!/,/\}\}/),{className:"template-tag",begin:/\{\{\{\{(?!\/)/,end:/\}\}\}\}/,contains:[u],starts:{end:/\{\{\{\{\//,returnEnd:!0,subLanguage:"xml"}},{className:"template-tag",begin:/\{\{\{\{\//,end:/\}\}\}\}/,contains:[b]},{className:"template-tag",begin:/\{\{#/,end:/\}\}/,contains:[u]},{className:"template-tag",begin:/\{\{(?=else\}\})/,end:/\}\}/,keywords:"else"},{className:"template-tag",begin:/\{\{\//,end:/\}\}/,contains:[b]},{className:"template-variable",begin:/\{\{\{/,end:/\}\}\}/,contains:[h]},{className:"template-variable",begin:/\{\{/,end:/\}\}/,contains:[h]}]}}}()); +hljs.registerLanguage("haskell",function(){"use strict";return function(e){var n={variants:[e.COMMENT("--","$"),e.COMMENT("{-","-}",{contains:["self"]})]},i={className:"meta",begin:"{-#",end:"#-}"},a={className:"meta",begin:"^#",end:"$"},s={className:"type",begin:"\\b[A-Z][\\w']*",relevance:0},l={begin:"\\(",end:"\\)",illegal:'"',contains:[i,a,{className:"type",begin:"\\b[A-Z][\\w]*(\\((\\.\\.|,|\\w+)\\))?"},e.inherit(e.TITLE_MODE,{begin:"[_a-z][\\w']*"}),n]};return{name:"Haskell",aliases:["hs"],keywords:"let in if then else case of where do module import hiding qualified type data newtype deriving class instance as default infix infixl infixr foreign export ccall stdcall cplusplus jvm dotnet safe unsafe family forall mdo proc rec",contains:[{beginKeywords:"module",end:"where",keywords:"module where",contains:[l,n],illegal:"\\W\\.|;"},{begin:"\\bimport\\b",end:"$",keywords:"import qualified as hiding",contains:[l,n],illegal:"\\W\\.|;"},{className:"class",begin:"^(\\s*)?(class|instance)\\b",end:"where",keywords:"class family instance where",contains:[s,l,n]},{className:"class",begin:"\\b(data|(new)?type)\\b",end:"$",keywords:"data family type newtype deriving",contains:[i,s,l,{begin:"{",end:"}",contains:l.contains},n]},{beginKeywords:"default",end:"$",contains:[s,l,n]},{beginKeywords:"infix infixl infixr",end:"$",contains:[e.C_NUMBER_MODE,n]},{begin:"\\bforeign\\b",end:"$",keywords:"foreign import export ccall stdcall cplusplus jvm dotnet safe unsafe",contains:[s,e.QUOTE_STRING_MODE,n]},{className:"meta",begin:"#!\\/usr\\/bin\\/env runhaskell",end:"$"},i,a,e.QUOTE_STRING_MODE,e.C_NUMBER_MODE,s,e.inherit(e.TITLE_MODE,{begin:"^[_a-z][\\w']*"}),n,{begin:"->|<-"}]}}}()); +hljs.registerLanguage("julia",function(){"use strict";return function(e){var r="[A-Za-z_\\u00A1-\\uFFFF][A-Za-z_0-9\\u00A1-\\uFFFF]*",t={$pattern:r,keyword:"in isa where baremodule begin break catch ccall const continue do else elseif end export false finally for function global if import importall let local macro module quote return true try using while type immutable abstract bitstype typealias ",literal:"true false ARGS C_NULL DevNull ENDIAN_BOM ENV I Inf Inf16 Inf32 Inf64 InsertionSort JULIA_HOME LOAD_PATH MergeSort NaN NaN16 NaN32 NaN64 PROGRAM_FILE QuickSort RoundDown RoundFromZero RoundNearest RoundNearestTiesAway RoundNearestTiesUp RoundToZero RoundUp STDERR STDIN STDOUT VERSION catalan e|0 eu|0 eulergamma golden im nothing pi ฮณ ฯ€ ฯ† ",built_in:"ANY AbstractArray AbstractChannel AbstractFloat AbstractMatrix AbstractRNG AbstractSerializer AbstractSet AbstractSparseArray AbstractSparseMatrix AbstractSparseVector AbstractString AbstractUnitRange AbstractVecOrMat AbstractVector Any ArgumentError Array AssertionError Associative Base64DecodePipe Base64EncodePipe Bidiagonal BigFloat BigInt BitArray BitMatrix BitVector Bool BoundsError BufferStream CachingPool CapturedException CartesianIndex CartesianRange Cchar Cdouble Cfloat Channel Char Cint Cintmax_t Clong Clonglong ClusterManager Cmd CodeInfo Colon Complex Complex128 Complex32 Complex64 CompositeException Condition ConjArray ConjMatrix ConjVector Cptrdiff_t Cshort Csize_t Cssize_t Cstring Cuchar Cuint Cuintmax_t Culong Culonglong Cushort Cwchar_t Cwstring DataType Date DateFormat DateTime DenseArray DenseMatrix DenseVecOrMat DenseVector Diagonal Dict DimensionMismatch Dims DirectIndexString Display DivideError DomainError EOFError EachLine Enum Enumerate ErrorException Exception ExponentialBackOff Expr Factorization FileMonitor Float16 Float32 Float64 Function Future GlobalRef GotoNode HTML Hermitian IO IOBuffer IOContext IOStream IPAddr IPv4 IPv6 IndexCartesian IndexLinear IndexStyle InexactError InitError Int Int128 Int16 Int32 Int64 Int8 IntSet Integer InterruptException InvalidStateException Irrational KeyError LabelNode LinSpace LineNumberNode LoadError LowerTriangular MIME Matrix MersenneTwister Method MethodError MethodTable Module NTuple NewvarNode NullException Nullable Number ObjectIdDict OrdinalRange OutOfMemoryError OverflowError Pair ParseError PartialQuickSort PermutedDimsArray Pipe PollingFileWatcher ProcessExitedException Ptr QuoteNode RandomDevice Range RangeIndex Rational RawFD ReadOnlyMemoryError Real ReentrantLock Ref Regex RegexMatch RemoteChannel RemoteException RevString RoundingMode RowVector SSAValue SegmentationFault SerializationState Set SharedArray SharedMatrix SharedVector Signed SimpleVector Slot SlotNumber SparseMatrixCSC SparseVector StackFrame StackOverflowError StackTrace StepRange StepRangeLen StridedArray StridedMatrix StridedVecOrMat StridedVector String SubArray SubString SymTridiagonal Symbol Symmetric SystemError TCPSocket Task Text TextDisplay Timer Tridiagonal Tuple Type TypeError TypeMapEntry TypeMapLevel TypeName TypeVar TypedSlot UDPSocket UInt UInt128 UInt16 UInt32 UInt64 UInt8 UndefRefError UndefVarError UnicodeError UniformScaling Union UnionAll UnitRange Unsigned UpperTriangular Val Vararg VecElement VecOrMat Vector VersionNumber Void WeakKeyDict WeakRef WorkerConfig WorkerPool "},a={keywords:t,illegal:/<\//},n={className:"subst",begin:/\$\(/,end:/\)/,keywords:t},o={className:"variable",begin:"\\$"+r},i={className:"string",contains:[e.BACKSLASH_ESCAPE,n,o],variants:[{begin:/\w*"""/,end:/"""\w*/,relevance:10},{begin:/\w*"/,end:/"\w*/}]},l={className:"string",contains:[e.BACKSLASH_ESCAPE,n,o],begin:"`",end:"`"},s={className:"meta",begin:"@"+r};return a.name="Julia",a.contains=[{className:"number",begin:/(\b0x[\d_]*(\.[\d_]*)?|0x\.\d[\d_]*)p[-+]?\d+|\b0[box][a-fA-F0-9][a-fA-F0-9_]*|(\b\d[\d_]*(\.[\d_]*)?|\.\d[\d_]*)([eEfF][-+]?\d+)?/,relevance:0},{className:"string",begin:/'(.|\\[xXuU][a-zA-Z0-9]+)'/},i,l,s,{className:"comment",variants:[{begin:"#=",end:"=#",relevance:10},{begin:"#",end:"$"}]},e.HASH_COMMENT_MODE,{className:"keyword",begin:"\\b(((abstract|primitive)\\s+)type|(mutable\\s+)?struct)\\b"},{begin:/<:/}],n.contains=a.contains,a}}()); +hljs.registerLanguage("nim",function(){"use strict";return function(e){return{name:"Nim",aliases:["nim"],keywords:{keyword:"addr and as asm bind block break case cast const continue converter discard distinct div do elif else end enum except export finally for from func generic if import in include interface is isnot iterator let macro method mixin mod nil not notin object of or out proc ptr raise ref return shl shr static template try tuple type using var when while with without xor yield",literal:"shared guarded stdin stdout stderr result true false",built_in:"int int8 int16 int32 int64 uint uint8 uint16 uint32 uint64 float float32 float64 bool char string cstring pointer expr stmt void auto any range array openarray varargs seq set clong culong cchar cschar cshort cint csize clonglong cfloat cdouble clongdouble cuchar cushort cuint culonglong cstringarray semistatic"},contains:[{className:"meta",begin:/{\./,end:/\.}/,relevance:10},{className:"string",begin:/[a-zA-Z]\w*"/,end:/"/,contains:[{begin:/""/}]},{className:"string",begin:/([a-zA-Z]\w*)?"""/,end:/"""/},e.QUOTE_STRING_MODE,{className:"type",begin:/\b[A-Z]\w+\b/,relevance:0},{className:"number",relevance:0,variants:[{begin:/\b(0[xX][0-9a-fA-F][_0-9a-fA-F]*)('?[iIuU](8|16|32|64))?/},{begin:/\b(0o[0-7][_0-7]*)('?[iIuUfF](8|16|32|64))?/},{begin:/\b(0(b|B)[01][_01]*)('?[iIuUfF](8|16|32|64))?/},{begin:/\b(\d[_\d]*)('?[iIuUfF](8|16|32|64))?/}]},e.HASH_COMMENT_MODE]}}}()); +hljs.registerLanguage("nix",function(){"use strict";return function(e){var n={keyword:"rec with let in inherit assert if else then",literal:"true false or and null",built_in:"import abort baseNameOf dirOf isNull builtins map removeAttrs throw toString derivation"},i={className:"subst",begin:/\$\{/,end:/}/,keywords:n},t={className:"string",contains:[i],variants:[{begin:"''",end:"''"},{begin:'"',end:'"'}]},s=[e.NUMBER_MODE,e.HASH_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,t,{begin:/[a-zA-Z0-9-_]+(\s*=)/,returnBegin:!0,relevance:0,contains:[{className:"attr",begin:/\S+/}]}];return i.contains=s,{name:"Nix",aliases:["nixos"],keywords:n,contains:s}}}()); +hljs.registerLanguage("r",function(){"use strict";return function(e){var n="([a-zA-Z]|\\.[a-zA-Z.])[a-zA-Z0-9._]*";return{name:"R",contains:[e.HASH_COMMENT_MODE,{begin:n,keywords:{$pattern:n,keyword:"function if in break next repeat else for return switch while try tryCatch stop warning require library attach detach source setMethod setGeneric setGroupGeneric setClass ...",literal:"NULL NA TRUE FALSE T F Inf NaN NA_integer_|10 NA_real_|10 NA_character_|10 NA_complex_|10"},relevance:0},{className:"number",begin:"0[xX][0-9a-fA-F]+[Li]?\\b",relevance:0},{className:"number",begin:"\\d+(?:[eE][+\\-]?\\d*)?L\\b",relevance:0},{className:"number",begin:"\\d+\\.(?!\\d)(?:i\\b)?",relevance:0},{className:"number",begin:"\\d+(?:\\.\\d*)?(?:[eE][+\\-]?\\d*)?i?\\b",relevance:0},{className:"number",begin:"\\.\\d+(?:[eE][+\\-]?\\d*)?i?\\b",relevance:0},{begin:"`",end:"`",relevance:0},{className:"string",contains:[e.BACKSLASH_ESCAPE],variants:[{begin:'"',end:'"'},{begin:"'",end:"'"}]}]}}}()); +hljs.registerLanguage("scala",function(){"use strict";return function(e){var n={className:"subst",variants:[{begin:"\\$[A-Za-z0-9_]+"},{begin:"\\${",end:"}"}]},a={className:"string",variants:[{begin:'"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{begin:'"""',end:'"""',relevance:10},{begin:'[a-z]+"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE,n]},{className:"string",begin:'[a-z]+"""',end:'"""',contains:[n],relevance:10}]},s={className:"type",begin:"\\b[A-Z][A-Za-z0-9_]*",relevance:0},t={className:"title",begin:/[^0-9\n\t "'(),.`{}\[\]:;][^\n\t "'(),.`{}\[\]:;]+|[^0-9\n\t "'(),.`{}\[\]:;=]/,relevance:0},i={className:"class",beginKeywords:"class object trait type",end:/[:={\[\n;]/,excludeEnd:!0,contains:[{beginKeywords:"extends with",relevance:10},{begin:/\[/,end:/\]/,excludeBegin:!0,excludeEnd:!0,relevance:0,contains:[s]},{className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,relevance:0,contains:[s]},t]},l={className:"function",beginKeywords:"def",end:/[:={\[(\n;]/,excludeEnd:!0,contains:[t]};return{name:"Scala",keywords:{literal:"true false null",keyword:"type yield lazy override def with val var sealed abstract private trait object if forSome for while throw finally protected extends import final return else break new catch super class case package default try this match continue throws implicit"},contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,a,{className:"symbol",begin:"'\\w[\\w\\d_]*(?!')"},s,l,i,e.C_NUMBER_MODE,{className:"meta",begin:"@[A-Za-z]+"}]}}}()); +hljs.registerLanguage("x86asm",function(){"use strict";return function(s){return{name:"Intel x86 Assembly",case_insensitive:!0,keywords:{$pattern:"[.%]?"+s.IDENT_RE,keyword:"lock rep repe repz repne repnz xaquire xrelease bnd nobnd aaa aad aam aas adc add and arpl bb0_reset bb1_reset bound bsf bsr bswap bt btc btr bts call cbw cdq cdqe clc cld cli clts cmc cmp cmpsb cmpsd cmpsq cmpsw cmpxchg cmpxchg486 cmpxchg8b cmpxchg16b cpuid cpu_read cpu_write cqo cwd cwde daa das dec div dmint emms enter equ f2xm1 fabs fadd faddp fbld fbstp fchs fclex fcmovb fcmovbe fcmove fcmovnb fcmovnbe fcmovne fcmovnu fcmovu fcom fcomi fcomip fcomp fcompp fcos fdecstp fdisi fdiv fdivp fdivr fdivrp femms feni ffree ffreep fiadd ficom ficomp fidiv fidivr fild fimul fincstp finit fist fistp fisttp fisub fisubr fld fld1 fldcw fldenv fldl2e fldl2t fldlg2 fldln2 fldpi fldz fmul fmulp fnclex fndisi fneni fninit fnop fnsave fnstcw fnstenv fnstsw fpatan fprem fprem1 fptan frndint frstor fsave fscale fsetpm fsin fsincos fsqrt fst fstcw fstenv fstp fstsw fsub fsubp fsubr fsubrp ftst fucom fucomi fucomip fucomp fucompp fxam fxch fxtract fyl2x fyl2xp1 hlt ibts icebp idiv imul in inc incbin insb insd insw int int01 int1 int03 int3 into invd invpcid invlpg invlpga iret iretd iretq iretw jcxz jecxz jrcxz jmp jmpe lahf lar lds lea leave les lfence lfs lgdt lgs lidt lldt lmsw loadall loadall286 lodsb lodsd lodsq lodsw loop loope loopne loopnz loopz lsl lss ltr mfence monitor mov movd movq movsb movsd movsq movsw movsx movsxd movzx mul mwait neg nop not or out outsb outsd outsw packssdw packsswb packuswb paddb paddd paddsb paddsiw paddsw paddusb paddusw paddw pand pandn pause paveb pavgusb pcmpeqb pcmpeqd pcmpeqw pcmpgtb pcmpgtd pcmpgtw pdistib pf2id pfacc pfadd pfcmpeq pfcmpge pfcmpgt pfmax pfmin pfmul pfrcp pfrcpit1 pfrcpit2 pfrsqit1 pfrsqrt pfsub pfsubr pi2fd pmachriw pmaddwd pmagw pmulhriw pmulhrwa pmulhrwc pmulhw pmullw pmvgezb pmvlzb pmvnzb pmvzb pop popa popad popaw popf popfd popfq popfw por prefetch prefetchw pslld psllq psllw psrad psraw psrld psrlq psrlw psubb psubd psubsb psubsiw psubsw psubusb psubusw psubw punpckhbw punpckhdq punpckhwd punpcklbw punpckldq punpcklwd push pusha pushad pushaw pushf pushfd pushfq pushfw pxor rcl rcr rdshr rdmsr rdpmc rdtsc rdtscp ret retf retn rol ror rdm rsdc rsldt rsm rsts sahf sal salc sar sbb scasb scasd scasq scasw sfence sgdt shl shld shr shrd sidt sldt skinit smi smint smintold smsw stc std sti stosb stosd stosq stosw str sub svdc svldt svts swapgs syscall sysenter sysexit sysret test ud0 ud1 ud2b ud2 ud2a umov verr verw fwait wbinvd wrshr wrmsr xadd xbts xchg xlatb xlat xor cmove cmovz cmovne cmovnz cmova cmovnbe cmovae cmovnb cmovb cmovnae cmovbe cmovna cmovg cmovnle cmovge cmovnl cmovl cmovnge cmovle cmovng cmovc cmovnc cmovo cmovno cmovs cmovns cmovp cmovpe cmovnp cmovpo je jz jne jnz ja jnbe jae jnb jb jnae jbe jna jg jnle jge jnl jl jnge jle jng jc jnc jo jno js jns jpo jnp jpe jp sete setz setne setnz seta setnbe setae setnb setnc setb setnae setcset setbe setna setg setnle setge setnl setl setnge setle setng sets setns seto setno setpe setp setpo setnp addps addss andnps andps cmpeqps cmpeqss cmpleps cmpless cmpltps cmpltss cmpneqps cmpneqss cmpnleps cmpnless cmpnltps cmpnltss cmpordps cmpordss cmpunordps cmpunordss cmpps cmpss comiss cvtpi2ps cvtps2pi cvtsi2ss cvtss2si cvttps2pi cvttss2si divps divss ldmxcsr maxps maxss minps minss movaps movhps movlhps movlps movhlps movmskps movntps movss movups mulps mulss orps rcpps rcpss rsqrtps rsqrtss shufps sqrtps sqrtss stmxcsr subps subss ucomiss unpckhps unpcklps xorps fxrstor fxrstor64 fxsave fxsave64 xgetbv xsetbv xsave xsave64 xsaveopt xsaveopt64 xrstor xrstor64 prefetchnta prefetcht0 prefetcht1 prefetcht2 maskmovq movntq pavgb pavgw pextrw pinsrw pmaxsw pmaxub pminsw pminub pmovmskb pmulhuw psadbw pshufw pf2iw pfnacc pfpnacc pi2fw pswapd maskmovdqu clflush movntdq movnti movntpd movdqa movdqu movdq2q movq2dq paddq pmuludq pshufd pshufhw pshuflw pslldq psrldq psubq punpckhqdq punpcklqdq addpd addsd andnpd andpd cmpeqpd cmpeqsd cmplepd cmplesd cmpltpd cmpltsd cmpneqpd cmpneqsd cmpnlepd cmpnlesd cmpnltpd cmpnltsd cmpordpd cmpordsd cmpunordpd cmpunordsd cmppd comisd cvtdq2pd cvtdq2ps cvtpd2dq cvtpd2pi cvtpd2ps cvtpi2pd cvtps2dq cvtps2pd cvtsd2si cvtsd2ss cvtsi2sd cvtss2sd cvttpd2pi cvttpd2dq cvttps2dq cvttsd2si divpd divsd maxpd maxsd minpd minsd movapd movhpd movlpd movmskpd movupd mulpd mulsd orpd shufpd sqrtpd sqrtsd subpd subsd ucomisd unpckhpd unpcklpd xorpd addsubpd addsubps haddpd haddps hsubpd hsubps lddqu movddup movshdup movsldup clgi stgi vmcall vmclear vmfunc vmlaunch vmload vmmcall vmptrld vmptrst vmread vmresume vmrun vmsave vmwrite vmxoff vmxon invept invvpid pabsb pabsw pabsd palignr phaddw phaddd phaddsw phsubw phsubd phsubsw pmaddubsw pmulhrsw pshufb psignb psignw psignd extrq insertq movntsd movntss lzcnt blendpd blendps blendvpd blendvps dppd dpps extractps insertps movntdqa mpsadbw packusdw pblendvb pblendw pcmpeqq pextrb pextrd pextrq phminposuw pinsrb pinsrd pinsrq pmaxsb pmaxsd pmaxud pmaxuw pminsb pminsd pminud pminuw pmovsxbw pmovsxbd pmovsxbq pmovsxwd pmovsxwq pmovsxdq pmovzxbw pmovzxbd pmovzxbq pmovzxwd pmovzxwq pmovzxdq pmuldq pmulld ptest roundpd roundps roundsd roundss crc32 pcmpestri pcmpestrm pcmpistri pcmpistrm pcmpgtq popcnt getsec pfrcpv pfrsqrtv movbe aesenc aesenclast aesdec aesdeclast aesimc aeskeygenassist vaesenc vaesenclast vaesdec vaesdeclast vaesimc vaeskeygenassist vaddpd vaddps vaddsd vaddss vaddsubpd vaddsubps vandpd vandps vandnpd vandnps vblendpd vblendps vblendvpd vblendvps vbroadcastss vbroadcastsd vbroadcastf128 vcmpeq_ospd vcmpeqpd vcmplt_ospd vcmpltpd vcmple_ospd vcmplepd vcmpunord_qpd vcmpunordpd vcmpneq_uqpd vcmpneqpd vcmpnlt_uspd vcmpnltpd vcmpnle_uspd vcmpnlepd vcmpord_qpd vcmpordpd vcmpeq_uqpd vcmpnge_uspd vcmpngepd vcmpngt_uspd vcmpngtpd vcmpfalse_oqpd vcmpfalsepd vcmpneq_oqpd vcmpge_ospd vcmpgepd vcmpgt_ospd vcmpgtpd vcmptrue_uqpd vcmptruepd vcmplt_oqpd vcmple_oqpd vcmpunord_spd vcmpneq_uspd vcmpnlt_uqpd vcmpnle_uqpd vcmpord_spd vcmpeq_uspd vcmpnge_uqpd vcmpngt_uqpd vcmpfalse_ospd vcmpneq_ospd vcmpge_oqpd vcmpgt_oqpd vcmptrue_uspd vcmppd vcmpeq_osps vcmpeqps vcmplt_osps vcmpltps vcmple_osps vcmpleps vcmpunord_qps vcmpunordps vcmpneq_uqps vcmpneqps vcmpnlt_usps vcmpnltps vcmpnle_usps vcmpnleps vcmpord_qps vcmpordps vcmpeq_uqps vcmpnge_usps vcmpngeps vcmpngt_usps vcmpngtps vcmpfalse_oqps vcmpfalseps vcmpneq_oqps vcmpge_osps vcmpgeps vcmpgt_osps vcmpgtps vcmptrue_uqps vcmptrueps vcmplt_oqps vcmple_oqps vcmpunord_sps vcmpneq_usps vcmpnlt_uqps vcmpnle_uqps vcmpord_sps vcmpeq_usps vcmpnge_uqps vcmpngt_uqps vcmpfalse_osps vcmpneq_osps vcmpge_oqps vcmpgt_oqps vcmptrue_usps vcmpps vcmpeq_ossd vcmpeqsd vcmplt_ossd vcmpltsd vcmple_ossd vcmplesd vcmpunord_qsd vcmpunordsd vcmpneq_uqsd vcmpneqsd vcmpnlt_ussd vcmpnltsd vcmpnle_ussd vcmpnlesd vcmpord_qsd vcmpordsd vcmpeq_uqsd vcmpnge_ussd vcmpngesd vcmpngt_ussd vcmpngtsd vcmpfalse_oqsd vcmpfalsesd vcmpneq_oqsd vcmpge_ossd vcmpgesd vcmpgt_ossd vcmpgtsd vcmptrue_uqsd vcmptruesd vcmplt_oqsd vcmple_oqsd vcmpunord_ssd vcmpneq_ussd vcmpnlt_uqsd vcmpnle_uqsd vcmpord_ssd vcmpeq_ussd vcmpnge_uqsd vcmpngt_uqsd vcmpfalse_ossd vcmpneq_ossd vcmpge_oqsd vcmpgt_oqsd vcmptrue_ussd vcmpsd vcmpeq_osss vcmpeqss vcmplt_osss vcmpltss vcmple_osss vcmpless vcmpunord_qss vcmpunordss vcmpneq_uqss vcmpneqss vcmpnlt_usss vcmpnltss vcmpnle_usss vcmpnless vcmpord_qss vcmpordss vcmpeq_uqss vcmpnge_usss vcmpngess vcmpngt_usss vcmpngtss vcmpfalse_oqss vcmpfalsess vcmpneq_oqss vcmpge_osss vcmpgess vcmpgt_osss vcmpgtss vcmptrue_uqss vcmptruess vcmplt_oqss vcmple_oqss vcmpunord_sss vcmpneq_usss vcmpnlt_uqss vcmpnle_uqss vcmpord_sss vcmpeq_usss vcmpnge_uqss vcmpngt_uqss vcmpfalse_osss vcmpneq_osss vcmpge_oqss vcmpgt_oqss vcmptrue_usss vcmpss vcomisd vcomiss vcvtdq2pd vcvtdq2ps vcvtpd2dq vcvtpd2ps vcvtps2dq vcvtps2pd vcvtsd2si vcvtsd2ss vcvtsi2sd vcvtsi2ss vcvtss2sd vcvtss2si vcvttpd2dq vcvttps2dq vcvttsd2si vcvttss2si vdivpd vdivps vdivsd vdivss vdppd vdpps vextractf128 vextractps vhaddpd vhaddps vhsubpd vhsubps vinsertf128 vinsertps vlddqu vldqqu vldmxcsr vmaskmovdqu vmaskmovps vmaskmovpd vmaxpd vmaxps vmaxsd vmaxss vminpd vminps vminsd vminss vmovapd vmovaps vmovd vmovq vmovddup vmovdqa vmovqqa vmovdqu vmovqqu vmovhlps vmovhpd vmovhps vmovlhps vmovlpd vmovlps vmovmskpd vmovmskps vmovntdq vmovntqq vmovntdqa vmovntpd vmovntps vmovsd vmovshdup vmovsldup vmovss vmovupd vmovups vmpsadbw vmulpd vmulps vmulsd vmulss vorpd vorps vpabsb vpabsw vpabsd vpacksswb vpackssdw vpackuswb vpackusdw vpaddb vpaddw vpaddd vpaddq vpaddsb vpaddsw vpaddusb vpaddusw vpalignr vpand vpandn vpavgb vpavgw vpblendvb vpblendw vpcmpestri vpcmpestrm vpcmpistri vpcmpistrm vpcmpeqb vpcmpeqw vpcmpeqd vpcmpeqq vpcmpgtb vpcmpgtw vpcmpgtd vpcmpgtq vpermilpd vpermilps vperm2f128 vpextrb vpextrw vpextrd vpextrq vphaddw vphaddd vphaddsw vphminposuw vphsubw vphsubd vphsubsw vpinsrb vpinsrw vpinsrd vpinsrq vpmaddwd vpmaddubsw vpmaxsb vpmaxsw vpmaxsd vpmaxub vpmaxuw vpmaxud vpminsb vpminsw vpminsd vpminub vpminuw vpminud vpmovmskb vpmovsxbw vpmovsxbd vpmovsxbq vpmovsxwd vpmovsxwq vpmovsxdq vpmovzxbw vpmovzxbd vpmovzxbq vpmovzxwd vpmovzxwq vpmovzxdq vpmulhuw vpmulhrsw vpmulhw vpmullw vpmulld vpmuludq vpmuldq vpor vpsadbw vpshufb vpshufd vpshufhw vpshuflw vpsignb vpsignw vpsignd vpslldq vpsrldq vpsllw vpslld vpsllq vpsraw vpsrad vpsrlw vpsrld vpsrlq vptest vpsubb vpsubw vpsubd vpsubq vpsubsb vpsubsw vpsubusb vpsubusw vpunpckhbw vpunpckhwd vpunpckhdq vpunpckhqdq vpunpcklbw vpunpcklwd vpunpckldq vpunpcklqdq vpxor vrcpps vrcpss vrsqrtps vrsqrtss vroundpd vroundps vroundsd vroundss vshufpd vshufps vsqrtpd vsqrtps vsqrtsd vsqrtss vstmxcsr vsubpd vsubps vsubsd vsubss vtestps vtestpd vucomisd vucomiss vunpckhpd vunpckhps vunpcklpd vunpcklps vxorpd vxorps vzeroall vzeroupper pclmullqlqdq pclmulhqlqdq pclmullqhqdq pclmulhqhqdq pclmulqdq vpclmullqlqdq vpclmulhqlqdq vpclmullqhqdq vpclmulhqhqdq vpclmulqdq vfmadd132ps vfmadd132pd vfmadd312ps vfmadd312pd vfmadd213ps vfmadd213pd vfmadd123ps vfmadd123pd vfmadd231ps vfmadd231pd vfmadd321ps vfmadd321pd vfmaddsub132ps vfmaddsub132pd vfmaddsub312ps vfmaddsub312pd vfmaddsub213ps vfmaddsub213pd vfmaddsub123ps vfmaddsub123pd vfmaddsub231ps vfmaddsub231pd vfmaddsub321ps vfmaddsub321pd vfmsub132ps vfmsub132pd vfmsub312ps vfmsub312pd vfmsub213ps vfmsub213pd vfmsub123ps vfmsub123pd vfmsub231ps vfmsub231pd vfmsub321ps vfmsub321pd vfmsubadd132ps vfmsubadd132pd vfmsubadd312ps vfmsubadd312pd vfmsubadd213ps vfmsubadd213pd vfmsubadd123ps vfmsubadd123pd vfmsubadd231ps vfmsubadd231pd vfmsubadd321ps vfmsubadd321pd vfnmadd132ps vfnmadd132pd vfnmadd312ps vfnmadd312pd vfnmadd213ps vfnmadd213pd vfnmadd123ps vfnmadd123pd vfnmadd231ps vfnmadd231pd vfnmadd321ps vfnmadd321pd vfnmsub132ps vfnmsub132pd vfnmsub312ps vfnmsub312pd vfnmsub213ps vfnmsub213pd vfnmsub123ps vfnmsub123pd vfnmsub231ps vfnmsub231pd vfnmsub321ps vfnmsub321pd vfmadd132ss vfmadd132sd vfmadd312ss vfmadd312sd vfmadd213ss vfmadd213sd vfmadd123ss vfmadd123sd vfmadd231ss vfmadd231sd vfmadd321ss vfmadd321sd vfmsub132ss vfmsub132sd vfmsub312ss vfmsub312sd vfmsub213ss vfmsub213sd vfmsub123ss vfmsub123sd vfmsub231ss vfmsub231sd vfmsub321ss vfmsub321sd vfnmadd132ss vfnmadd132sd vfnmadd312ss vfnmadd312sd vfnmadd213ss vfnmadd213sd vfnmadd123ss vfnmadd123sd vfnmadd231ss vfnmadd231sd vfnmadd321ss vfnmadd321sd vfnmsub132ss vfnmsub132sd vfnmsub312ss vfnmsub312sd vfnmsub213ss vfnmsub213sd vfnmsub123ss vfnmsub123sd vfnmsub231ss vfnmsub231sd vfnmsub321ss vfnmsub321sd rdfsbase rdgsbase rdrand wrfsbase wrgsbase vcvtph2ps vcvtps2ph adcx adox rdseed clac stac xstore xcryptecb xcryptcbc xcryptctr xcryptcfb xcryptofb montmul xsha1 xsha256 llwpcb slwpcb lwpval lwpins vfmaddpd vfmaddps vfmaddsd vfmaddss vfmaddsubpd vfmaddsubps vfmsubaddpd vfmsubaddps vfmsubpd vfmsubps vfmsubsd vfmsubss vfnmaddpd vfnmaddps vfnmaddsd vfnmaddss vfnmsubpd vfnmsubps vfnmsubsd vfnmsubss vfrczpd vfrczps vfrczsd vfrczss vpcmov vpcomb vpcomd vpcomq vpcomub vpcomud vpcomuq vpcomuw vpcomw vphaddbd vphaddbq vphaddbw vphadddq vphaddubd vphaddubq vphaddubw vphaddudq vphadduwd vphadduwq vphaddwd vphaddwq vphsubbw vphsubdq vphsubwd vpmacsdd vpmacsdqh vpmacsdql vpmacssdd vpmacssdqh vpmacssdql vpmacsswd vpmacssww vpmacswd vpmacsww vpmadcsswd vpmadcswd vpperm vprotb vprotd vprotq vprotw vpshab vpshad vpshaq vpshaw vpshlb vpshld vpshlq vpshlw vbroadcasti128 vpblendd vpbroadcastb vpbroadcastw vpbroadcastd vpbroadcastq vpermd vpermpd vpermps vpermq vperm2i128 vextracti128 vinserti128 vpmaskmovd vpmaskmovq vpsllvd vpsllvq vpsravd vpsrlvd vpsrlvq vgatherdpd vgatherqpd vgatherdps vgatherqps vpgatherdd vpgatherqd vpgatherdq vpgatherqq xabort xbegin xend xtest andn bextr blci blcic blsi blsic blcfill blsfill blcmsk blsmsk blsr blcs bzhi mulx pdep pext rorx sarx shlx shrx tzcnt tzmsk t1mskc valignd valignq vblendmpd vblendmps vbroadcastf32x4 vbroadcastf64x4 vbroadcasti32x4 vbroadcasti64x4 vcompresspd vcompressps vcvtpd2udq vcvtps2udq vcvtsd2usi vcvtss2usi vcvttpd2udq vcvttps2udq vcvttsd2usi vcvttss2usi vcvtudq2pd vcvtudq2ps vcvtusi2sd vcvtusi2ss vexpandpd vexpandps vextractf32x4 vextractf64x4 vextracti32x4 vextracti64x4 vfixupimmpd vfixupimmps vfixupimmsd vfixupimmss vgetexppd vgetexpps vgetexpsd vgetexpss vgetmantpd vgetmantps vgetmantsd vgetmantss vinsertf32x4 vinsertf64x4 vinserti32x4 vinserti64x4 vmovdqa32 vmovdqa64 vmovdqu32 vmovdqu64 vpabsq vpandd vpandnd vpandnq vpandq vpblendmd vpblendmq vpcmpltd vpcmpled vpcmpneqd vpcmpnltd vpcmpnled vpcmpd vpcmpltq vpcmpleq vpcmpneqq vpcmpnltq vpcmpnleq vpcmpq vpcmpequd vpcmpltud vpcmpleud vpcmpnequd vpcmpnltud vpcmpnleud vpcmpud vpcmpequq vpcmpltuq vpcmpleuq vpcmpnequq vpcmpnltuq vpcmpnleuq vpcmpuq vpcompressd vpcompressq vpermi2d vpermi2pd vpermi2ps vpermi2q vpermt2d vpermt2pd vpermt2ps vpermt2q vpexpandd vpexpandq vpmaxsq vpmaxuq vpminsq vpminuq vpmovdb vpmovdw vpmovqb vpmovqd vpmovqw vpmovsdb vpmovsdw vpmovsqb vpmovsqd vpmovsqw vpmovusdb vpmovusdw vpmovusqb vpmovusqd vpmovusqw vpord vporq vprold vprolq vprolvd vprolvq vprord vprorq vprorvd vprorvq vpscatterdd vpscatterdq vpscatterqd vpscatterqq vpsraq vpsravq vpternlogd vpternlogq vptestmd vptestmq vptestnmd vptestnmq vpxord vpxorq vrcp14pd vrcp14ps vrcp14sd vrcp14ss vrndscalepd vrndscaleps vrndscalesd vrndscaless vrsqrt14pd vrsqrt14ps vrsqrt14sd vrsqrt14ss vscalefpd vscalefps vscalefsd vscalefss vscatterdpd vscatterdps vscatterqpd vscatterqps vshuff32x4 vshuff64x2 vshufi32x4 vshufi64x2 kandnw kandw kmovw knotw kortestw korw kshiftlw kshiftrw kunpckbw kxnorw kxorw vpbroadcastmb2q vpbroadcastmw2d vpconflictd vpconflictq vplzcntd vplzcntq vexp2pd vexp2ps vrcp28pd vrcp28ps vrcp28sd vrcp28ss vrsqrt28pd vrsqrt28ps vrsqrt28sd vrsqrt28ss vgatherpf0dpd vgatherpf0dps vgatherpf0qpd vgatherpf0qps vgatherpf1dpd vgatherpf1dps vgatherpf1qpd vgatherpf1qps vscatterpf0dpd vscatterpf0dps vscatterpf0qpd vscatterpf0qps vscatterpf1dpd vscatterpf1dps vscatterpf1qpd vscatterpf1qps prefetchwt1 bndmk bndcl bndcu bndcn bndmov bndldx bndstx sha1rnds4 sha1nexte sha1msg1 sha1msg2 sha256rnds2 sha256msg1 sha256msg2 hint_nop0 hint_nop1 hint_nop2 hint_nop3 hint_nop4 hint_nop5 hint_nop6 hint_nop7 hint_nop8 hint_nop9 hint_nop10 hint_nop11 hint_nop12 hint_nop13 hint_nop14 hint_nop15 hint_nop16 hint_nop17 hint_nop18 hint_nop19 hint_nop20 hint_nop21 hint_nop22 hint_nop23 hint_nop24 hint_nop25 hint_nop26 hint_nop27 hint_nop28 hint_nop29 hint_nop30 hint_nop31 hint_nop32 hint_nop33 hint_nop34 hint_nop35 hint_nop36 hint_nop37 hint_nop38 hint_nop39 hint_nop40 hint_nop41 hint_nop42 hint_nop43 hint_nop44 hint_nop45 hint_nop46 hint_nop47 hint_nop48 hint_nop49 hint_nop50 hint_nop51 hint_nop52 hint_nop53 hint_nop54 hint_nop55 hint_nop56 hint_nop57 hint_nop58 hint_nop59 hint_nop60 hint_nop61 hint_nop62 hint_nop63",built_in:"ip eip rip al ah bl bh cl ch dl dh sil dil bpl spl r8b r9b r10b r11b r12b r13b r14b r15b ax bx cx dx si di bp sp r8w r9w r10w r11w r12w r13w r14w r15w eax ebx ecx edx esi edi ebp esp eip r8d r9d r10d r11d r12d r13d r14d r15d rax rbx rcx rdx rsi rdi rbp rsp r8 r9 r10 r11 r12 r13 r14 r15 cs ds es fs gs ss st st0 st1 st2 st3 st4 st5 st6 st7 mm0 mm1 mm2 mm3 mm4 mm5 mm6 mm7 xmm0 xmm1 xmm2 xmm3 xmm4 xmm5 xmm6 xmm7 xmm8 xmm9 xmm10 xmm11 xmm12 xmm13 xmm14 xmm15 xmm16 xmm17 xmm18 xmm19 xmm20 xmm21 xmm22 xmm23 xmm24 xmm25 xmm26 xmm27 xmm28 xmm29 xmm30 xmm31 ymm0 ymm1 ymm2 ymm3 ymm4 ymm5 ymm6 ymm7 ymm8 ymm9 ymm10 ymm11 ymm12 ymm13 ymm14 ymm15 ymm16 ymm17 ymm18 ymm19 ymm20 ymm21 ymm22 ymm23 ymm24 ymm25 ymm26 ymm27 ymm28 ymm29 ymm30 ymm31 zmm0 zmm1 zmm2 zmm3 zmm4 zmm5 zmm6 zmm7 zmm8 zmm9 zmm10 zmm11 zmm12 zmm13 zmm14 zmm15 zmm16 zmm17 zmm18 zmm19 zmm20 zmm21 zmm22 zmm23 zmm24 zmm25 zmm26 zmm27 zmm28 zmm29 zmm30 zmm31 k0 k1 k2 k3 k4 k5 k6 k7 bnd0 bnd1 bnd2 bnd3 cr0 cr1 cr2 cr3 cr4 cr8 dr0 dr1 dr2 dr3 dr8 tr3 tr4 tr5 tr6 tr7 r0 r1 r2 r3 r4 r5 r6 r7 r0b r1b r2b r3b r4b r5b r6b r7b r0w r1w r2w r3w r4w r5w r6w r7w r0d r1d r2d r3d r4d r5d r6d r7d r0h r1h r2h r3h r0l r1l r2l r3l r4l r5l r6l r7l r8l r9l r10l r11l r12l r13l r14l r15l db dw dd dq dt ddq do dy dz resb resw resd resq rest resdq reso resy resz incbin equ times byte word dword qword nosplit rel abs seg wrt strict near far a32 ptr",meta:"%define %xdefine %+ %undef %defstr %deftok %assign %strcat %strlen %substr %rotate %elif %else %endif %if %ifmacro %ifctx %ifidn %ifidni %ifid %ifnum %ifstr %iftoken %ifempty %ifenv %error %warning %fatal %rep %endrep %include %push %pop %repl %pathsearch %depend %use %arg %stacksize %local %line %comment %endcomment .nolist __FILE__ __LINE__ __SECT__ __BITS__ __OUTPUT_FORMAT__ __DATE__ __TIME__ __DATE_NUM__ __TIME_NUM__ __UTC_DATE__ __UTC_TIME__ __UTC_DATE_NUM__ __UTC_TIME_NUM__ __PASS__ struc endstruc istruc at iend align alignb sectalign daz nodaz up down zero default option assume public bits use16 use32 use64 default section segment absolute extern global common cpu float __utf16__ __utf16le__ __utf16be__ __utf32__ __utf32le__ __utf32be__ __float8__ __float16__ __float32__ __float64__ __float80m__ __float80e__ __float128l__ __float128h__ __Infinity__ __QNaN__ __SNaN__ Inf NaN QNaN SNaN float8 float16 float32 float64 float80m float80e float128l float128h __FLOAT_DAZ__ __FLOAT_ROUND__ __FLOAT__"},contains:[s.COMMENT(";","$",{relevance:0}),{className:"number",variants:[{begin:"\\b(?:([0-9][0-9_]*)?\\.[0-9_]*(?:[eE][+-]?[0-9_]+)?|(0[Xx])?[0-9][0-9_]*\\.?[0-9_]*(?:[pP](?:[+-]?[0-9_]+)?)?)\\b",relevance:0},{begin:"\\$[0-9][0-9A-Fa-f]*",relevance:0},{begin:"\\b(?:[0-9A-Fa-f][0-9A-Fa-f_]*[Hh]|[0-9][0-9_]*[DdTt]?|[0-7][0-7_]*[QqOo]|[0-1][0-1_]*[BbYy])\\b"},{begin:"\\b(?:0[Xx][0-9A-Fa-f_]+|0[DdTt][0-9_]+|0[QqOo][0-7_]+|0[BbYy][0-1_]+)\\b"}]},s.QUOTE_STRING_MODE,{className:"string",variants:[{begin:"'",end:"[^\\\\]'"},{begin:"`",end:"[^\\\\]`"}],relevance:0},{className:"symbol",variants:[{begin:"^\\s*[A-Za-z._?][A-Za-z0-9_$#@~.?]*(:|\\s+label)"},{begin:"^\\s*%%[A-Za-z0-9_$#@~.?]*:"}],relevance:0},{className:"subst",begin:"%[0-9]+",relevance:0},{className:"subst",begin:"%!S+",relevance:0},{className:"meta",begin:/^\s*\.[\w_-]+/}]}}}()); \ No newline at end of file diff --git a/docs/theme/index.hbs b/docs/theme/index.hbs new file mode 100644 index 00000000..b1834189 --- /dev/null +++ b/docs/theme/index.hbs @@ -0,0 +1,367 @@ + + + + + + {{ title }} + {{#if is_print }} + + {{/if}} + {{#if base_url}} + + {{/if}} + + + + {{> head}} + + + + + + {{#if favicon_svg}} + + {{/if}} + {{#if favicon_png}} + + {{/if}} + + + + {{#if print_enable}} + + {{/if}} + + + + + + + + + + + {{#each additional_css}} + + {{/each}} + + {{#if mathjax_support}} + + + {{/if}} + + + + + + + +
+
+

Keyboard shortcuts

+
+

Press โ† or โ†’ to navigate between chapters

+ {{#if search_enabled}} +

Press S or / to search in the book

+ {{/if}} +

Press ? to show this help

+

Press Esc to hide this help

+
+
+
+
+ + + + + + + + + + + + + +
+ +
+ {{> header}} +
+ + + {{#if search_enabled}} + + {{/if}} + + + + +
+
+ {{{ content }}} +
+ + +
+
+ + + +
+ + + + + + + + {{#if live_reload_endpoint}} + + + {{/if}} + + {{#if playground_line_numbers}} + + {{/if}} + + {{#if playground_copyable}} + + {{/if}} + + {{#if playground_js}} + + + + + + {{/if}} + + {{#if search_js}} + + + + {{/if}} + + + + + + + {{#each additional_js}} + + {{/each}} + + {{#if is_print}} + {{#if mathjax_support}} + + {{else}} + + {{/if}} + {{/if}} + + {{#if fragment_map}} + + {{/if}} + +
+ + diff --git a/phpunit.xml.dist b/phpunit.xml.dist index 3ff1c0ea..7ffc35a6 100644 --- a/phpunit.xml.dist +++ b/phpunit.xml.dist @@ -1,25 +1,17 @@ - - - src - + cacheDirectory="./var/.phpunit.cache" + backupStaticProperties="false"> + - + @@ -30,4 +22,9 @@ tests + + + src + + diff --git a/src/Parameters/Config/DocumentOptionsStore.php b/src/Attribute/ApiParameterMapper.php similarity index 61% rename from src/Parameters/Config/DocumentOptionsStore.php rename to src/Attribute/ApiParameterMapper.php index a5aae896..01e76eda 100644 --- a/src/Parameters/Config/DocumentOptionsStore.php +++ b/src/Attribute/ApiParameterMapper.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -18,27 +18,20 @@ * with BigBlueButton; if not, see . */ -namespace BigBlueButton\Parameters\Config; +namespace BigBlueButton\Attribute; -class DocumentOptionsStore +#[\Attribute(\Attribute::TARGET_METHOD)] +class ApiParameterMapper { - private $attributes = []; + private string $attributeName; - public function __construct(array $attributes = []) + public function __construct(string $attributeName) { - $this->attributes = $attributes; + $this->attributeName = $attributeName; } - public function addAttribute($name, $value) + public function getAttributeName(): string { - if (is_bool($value)) { - $value = $value ? 'true' : 'false'; - } - $this->attributes[$name] = $value; - } - - public function getAttributes() - { - return $this->attributes; + return $this->attributeName; } } diff --git a/src/BigBlueButton.php b/src/BigBlueButton.php index 414b1127..2a741f6f 100644 --- a/src/BigBlueButton.php +++ b/src/BigBlueButton.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -25,6 +25,8 @@ use BigBlueButton\Parameters\CreateMeetingParameters; use BigBlueButton\Parameters\DeleteRecordingsParameters; use BigBlueButton\Parameters\EndMeetingParameters; +use BigBlueButton\Parameters\FeedbackParameters; +use BigBlueButton\Parameters\GetJoinUrlParameters; use BigBlueButton\Parameters\GetMeetingInfoParameters; use BigBlueButton\Parameters\GetRecordingsParameters; use BigBlueButton\Parameters\GetRecordingTextTracksParameters; @@ -35,11 +37,14 @@ use BigBlueButton\Parameters\JoinMeetingParameters; use BigBlueButton\Parameters\PublishRecordingsParameters; use BigBlueButton\Parameters\PutRecordingTextTrackParameters; +use BigBlueButton\Parameters\SendChatMessageParameters; use BigBlueButton\Parameters\UpdateRecordingsParameters; use BigBlueButton\Responses\ApiVersionResponse; use BigBlueButton\Responses\CreateMeetingResponse; use BigBlueButton\Responses\DeleteRecordingsResponse; use BigBlueButton\Responses\EndMeetingResponse; +use BigBlueButton\Responses\FeedbackResponse; +use BigBlueButton\Responses\GetJoinUrlResponse; use BigBlueButton\Responses\GetMeetingInfoResponse; use BigBlueButton\Responses\GetMeetingsResponse; use BigBlueButton\Responses\GetRecordingsResponse; @@ -47,10 +52,12 @@ use BigBlueButton\Responses\HooksCreateResponse; use BigBlueButton\Responses\HooksDestroyResponse; use BigBlueButton\Responses\HooksListResponse; +use BigBlueButton\Responses\InsertDocumentResponse; use BigBlueButton\Responses\IsMeetingRunningResponse; use BigBlueButton\Responses\JoinMeetingResponse; use BigBlueButton\Responses\PublishRecordingsResponse; use BigBlueButton\Responses\PutRecordingTextTrackResponse; +use BigBlueButton\Responses\SendChatMessageResponse; use BigBlueButton\Responses\UpdateRecordingsResponse; use BigBlueButton\Util\UrlBuilder; @@ -75,7 +82,7 @@ class BigBlueButton * @deprecated This property has been replaced by property in UrlBuilder-class. * User property via $this->getUrlBuilder()->setHashingAlgorithm() and $this->getUrlBuilder()->getHashingAlgorithm(). */ - protected string $hashingAlgorithm; + protected HashingAlgorithm $hashingAlgorithm; /** * @var array @@ -89,35 +96,21 @@ class BigBlueButton /** * @param null|array $opts */ - public function __construct(?string $baseUrl = null, ?string $secret = null, ?array $opts = []) - { - // Provide an early error message if configuration is wrong - if (is_null($baseUrl) && false === getenv('BBB_SERVER_BASE_URL')) { - throw new \RuntimeException('No BBB-Server-Url found! Please provide it either in constructor ' . - "(1st argument) or by environment variable 'BBB_SERVER_BASE_URL'!"); - } - - if (is_null($secret) && false === getenv('BBB_SECRET') && false === getenv('BBB_SECURITY_SALT')) { - throw new \RuntimeException('No BBB-Secret (or BBB-Salt) found! Please provide it either in constructor ' . - "(2nd argument) or by environment variable 'BBB_SECRET' (or 'BBB_SECURITY_SALT')!"); - } - - // Keeping backward compatibility with older deployed versions - // BBB_SECRET is the new variable name and have higher priority against the old named BBB_SECURITY_SALT - // Reminder: getenv() will return FALSE if not set. But bool is not accepted by $this->bbbSecret - // nor $this->bbbBaseUrl (only strings), thus FALSE will be converted automatically to an empty - // string (''). Having a bool should be not possible due to the checks above and the automated - // conversion, but PHPStan is still unhappy, so it's covered explicit by adding `?: ''`. - $bbbBaseUrl = $baseUrl ?: getenv('BBB_SERVER_BASE_URL') ?: ''; - $bbbSecret = $secret ?: getenv('BBB_SECRET') ?: getenv('BBB_SECURITY_SALT') ?: ''; - $hashingAlgorithm = HashingAlgorithm::SHA_256; + public function __construct( + ?string $baseUrl = null, + #[\SensitiveParameter] + ?string $secret = null, + ?array $opts = [], + ?UrlBuilder $urlBuilder = null, + ) { + $urlBuilder ??= UrlBuilder::fromEnvVars($baseUrl, $secret); // initialize deprecated properties - $this->bbbBaseUrl = $bbbBaseUrl; - $this->bbbSecret = $bbbSecret; - $this->hashingAlgorithm = $hashingAlgorithm; + $this->bbbBaseUrl = $urlBuilder->getBaseUrl(); + $this->bbbSecret = $urlBuilder->getSecret(); + $this->hashingAlgorithm = $urlBuilder->getHashingAlgorithm(); - $this->urlBuilder = new UrlBuilder($bbbSecret, $bbbBaseUrl, $hashingAlgorithm); + $this->urlBuilder = $urlBuilder; $this->curlOpts = $opts['curl'] ?? []; } @@ -137,6 +130,7 @@ public function getApiVersion(): ApiVersionResponse -- join -- end -- insertDocument + -- sendChatMessage */ /** @@ -152,13 +146,13 @@ public function getCreateMeetingUrl(CreateMeetingParameters $createMeetingParams */ public function createMeeting(CreateMeetingParameters $createMeetingParams): CreateMeetingResponse { - $xml = $this->processXmlResponse($this->getUrlBuilder()->getCreateMeetingUrl($createMeetingParams), $createMeetingParams->getPresentationsAsXML()); + $xml = $this->processXmlResponse($this->getUrlBuilder()->getCreateMeetingUrl($createMeetingParams), $createMeetingParams->getModulesAsXML()); return new CreateMeetingResponse($xml); } /** - * @deprecated Replaced by same function-name provided by UrlBuilder-class + * @deprecated Replaced by the same function-name provided by UrlBuilder-class */ public function getJoinMeetingURL(JoinMeetingParameters $joinMeetingParams): string { @@ -175,6 +169,24 @@ public function joinMeeting(JoinMeetingParameters $joinMeetingParams): JoinMeeti return new JoinMeetingResponse($xml); } + /** + * Get a new join URL for an existing user session. + * + * This endpoint generates a new /join URL that can be used to create a new session + * for an existing user with the same user ID. This is particularly useful for + * hybrid environments where multiple screens in the same room each require a + * distinct session with different layouts, or for seamless user session transfers + * to another device. + * + * @throws BadResponseException|\RuntimeException + */ + public function getJoinUrl(GetJoinUrlParameters $getJoinUrlParams): GetJoinUrlResponse + { + $xml = $this->processXmlResponse($this->getUrlBuilder()->getGetJoinUrlUrl($getJoinUrlParams)); + + return new GetJoinUrlResponse($xml); + } + /** * @deprecated Replaced by same function-name provided by UrlBuilder-class */ @@ -204,11 +216,34 @@ public function getInsertDocumentUrl(InsertDocumentParameters $insertDocumentPar /** * @throws BadResponseException|\RuntimeException */ - public function insertDocument(InsertDocumentParameters $insertDocumentParams): CreateMeetingResponse + public function insertDocument(InsertDocumentParameters $insertDocumentParams): InsertDocumentResponse { $xml = $this->processXmlResponse($this->getUrlBuilder()->getInsertDocumentUrl($insertDocumentParams), $insertDocumentParams->getPresentationsAsXML()); - return new CreateMeetingResponse($xml); + return new InsertDocumentResponse($xml); + } + + public function sendChatMessage(SendChatMessageParameters $sendChatMessageParams): SendChatMessageResponse + { + $xml = $this->processXmlResponse($this->getUrlBuilder()->getSendChatMessageUrl($sendChatMessageParams)); + + return new SendChatMessageResponse($xml); + } + + /** + * Submit feedback for a meeting or session. + * + * This endpoint replaces the old /html5client/feedback endpoint with /api/feedback. + * It allows users to submit feedback about their meeting experience, including + * ratings and comments. + * + * @throws BadResponseException|\RuntimeException + */ + public function feedback(FeedbackParameters $feedbackParams): FeedbackResponse + { + $json = $this->processJsonResponse($this->getUrlBuilder()->getFeedbackUrl($feedbackParams)); + + return new FeedbackResponse($json); } // __________________ BBB MONITORING METHODS _________________ @@ -301,11 +336,9 @@ public function getRecordingsUrl(GetRecordingsParameters $recordingsParams): str } /** - * @param mixed $recordingParams - * * @throws BadResponseException|\RuntimeException */ - public function getRecordings($recordingParams): GetRecordingsResponse + public function getRecordings(GetRecordingsParameters $recordingParams): GetRecordingsResponse { $xml = $this->processXmlResponse($this->getUrlBuilder()->getRecordingsUrl($recordingParams)); @@ -413,11 +446,9 @@ public function getHooksCreateUrl(HooksCreateParameters $hookCreateParams): stri } /** - * @param mixed $hookCreateParams - * * @throws BadResponseException */ - public function hooksCreate($hookCreateParams): HooksCreateResponse + public function hooksCreate(HooksCreateParameters $hookCreateParams): HooksCreateResponse { $xml = $this->processXmlResponse($this->getUrlBuilder()->getHooksCreateUrl($hookCreateParams)); @@ -451,11 +482,9 @@ public function getHooksDestroyUrl(HooksDestroyParameters $hooksDestroyParams): } /** - * @param mixed $hooksDestroyParams - * * @throws BadResponseException */ - public function hooksDestroy($hooksDestroyParams): HooksDestroyResponse + public function hooksDestroy(HooksDestroyParameters $hooksDestroyParams): HooksDestroyResponse { $xml = $this->processXmlResponse($this->getUrlBuilder()->getHooksDestroyUrl($hooksDestroyParams)); @@ -492,13 +521,13 @@ public function setTimeOut(int $TimeOutInSeconds): self return $this; } - public function setHashingAlgorithm(string $hashingAlgorithm): void + public function setHashingAlgorithm(HashingAlgorithm $hashingAlgorithm): void { $this->hashingAlgorithm = $hashingAlgorithm; $this->getUrlBuilder()->setHashingAlgorithm($hashingAlgorithm); } - public function getHashingAlgorithm(string $hashingAlgorithm): string + public function getHashingAlgorithm(): HashingAlgorithm { $this->hashingAlgorithm = $this->getUrlBuilder()->getHashingAlgorithm(); @@ -537,22 +566,29 @@ private function sendRequest(string $url, string $payload = '', string $contentT $ch = curl_init(); $cookieFile = tmpfile(); - if (!$ch) { // @phpstan-ignore-line - throw new \RuntimeException('Unhandled curl error: ' . curl_error($ch)); + if (false === $ch) { + throw new \RuntimeException('Failed to initialize cURL'); } - // JSESSIONID + // JSESSIONID - Secure cookie handling with internal validation if ($cookieFile) { $cookieFilePath = stream_get_meta_data($cookieFile)['uri']; - $cookies = file_get_contents($cookieFilePath); + // Set secure cookie options curl_setopt($ch, CURLOPT_COOKIEFILE, $cookieFilePath); curl_setopt($ch, CURLOPT_COOKIEJAR, $cookieFilePath); - if ($cookies) { - if (false !== mb_strpos($cookies, 'JSESSIONID')) { - preg_match('/(?:JSESSIONID\s*)(?.*)/', $cookies, $output_array); - $this->setJSessionId($output_array['JSESSIONID']); + // Read and validate cookies safely with internal validation + $cookies = file_get_contents($cookieFilePath); + + if (false !== $cookies && mb_strlen($cookies) > 0) { + // Validate cookie format before processing + if ($this->isValidCookieFormat($cookies)) { + $sessionId = $this->extractJSessionIdSafely($cookies); + + if (null !== $sessionId) { + $this->setJSessionId($sessionId); + } } } } @@ -607,6 +643,11 @@ private function sendRequest(string $url, string $payload = '', string $contentT curl_close($ch); unset($ch); + // Clean up temporary cookie file + if ($cookieFile) { + fclose($cookieFile); + } + // RETURN return $data; } @@ -628,8 +669,112 @@ private function processXmlResponse(string $url, string $payload = ''): \SimpleX * * @throws BadResponseException */ - private function processJsonResponse(string $url, string $payload = ''): string + private function processJsonResponse(string $url): string { - return $this->sendRequest($url, $payload, 'application/json'); + return $this->sendRequest($url, contentType: 'application/json'); + } + + /** + * Validates cookie format to prevent injection attacks. + */ + private function isValidCookieFormat(string $cookies): bool + { + // Check for basic cookie format and reject suspicious content + $lines = explode("\n", $cookies); + + foreach ($lines as $line) { + $line = mb_trim($line); + + if (empty($line)) { + return false; // Empty lines are invalid + } + + // Basic cookie format validation: name=value with optional attributes + if (!preg_match('/^[a-zA-Z0-9._-]+=[^;\r\n]*$/', $line)) { + // Check if it's a valid cookie with attributes (allow spaces after semicolons) + // Allow attributes without values like HttpOnly, Secure, etc. + if (!preg_match('/^[a-zA-Z0-9._-]+=[^;\r\n]*(?:;\s*[a-zA-Z0-9._-]+(?:\s*=\s*[^;\r\n]*)?)*$/', $line)) { + return false; + } + } + + // Reject potentially dangerous content + if (false !== mb_strpos($line, ' 1000) { + return false; + } + } + + return true; + } + + /** + * Safely extracts JSESSIONID from cookie string with validation. + */ + private function extractJSessionIdSafely(string $cookies): ?string + { + // Use case-insensitive regex pattern to find JSESSIONID with its value + // Match the entire JSESSIONID=value pattern to validate the full value + if (preg_match('/(?:JSESSIONID|jsessionid)\s*=\s*([^;]+)/', $cookies, $matches)) { + $sessionIdValue = mb_trim($matches[1]); + + // Check for dangerous patterns in the session ID value + if (false !== mb_strpos($sessionIdValue, '../') + || false !== mb_strpos($sessionIdValue, '<') + || false !== mb_strpos($sessionIdValue, '>') + || false !== mb_strpos($sessionIdValue, '@') + || false !== mb_strpos($sessionIdValue, ' ') + || false !== mb_strpos($sessionIdValue, 'javascript:') + || false !== mb_strpos($sessionIdValue, 'isValidSessionId($sessionId)) { + return $sessionId; + } + } + } + + return null; + } + + /** + * Validate session ID format for security. + */ + private function isValidSessionId(string $sessionId): bool + { + // Session IDs should be alphanumeric with limited special characters + // and reasonable length (typical Java session IDs are 32 chars) + $length = mb_strlen($sessionId); + + // Check length constraints + if ($length < 1 || $length > 100) { + return false; + } + + // Check for valid characters (alphanumeric, underscore, hyphen, dot only) + // This regex will reject @, spaces, and other invalid characters + if (!preg_match('/^[a-zA-Z0-9._-]+$/', $sessionId)) { + return false; + } + + // Reject potentially dangerous patterns + if (false !== mb_strpos($sessionId, '../')) { + return false; + } + + return true; } } diff --git a/src/Core/ApiMethod.php b/src/Core/ApiMethod.php index 789f7558..c69a7c5f 100644 --- a/src/Core/ApiMethod.php +++ b/src/Core/ApiMethod.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -25,7 +25,6 @@ final class ApiMethod public const CREATE = 'create'; public const JOIN = 'join'; public const INSERT_DOCUMENT = 'insertDocument'; - public const ENTER = 'enter'; public const END = 'end'; public const IS_MEETING_RUNNING = 'isMeetingRunning'; public const GET_MEETING_INFO = 'getMeetingInfo'; @@ -37,6 +36,9 @@ final class ApiMethod public const UPDATE_RECORDINGS = 'updateRecordings'; public const GET_RECORDING_TEXT_TRACKS = 'getRecordingTextTracks'; public const PUT_RECORDING_TEXT_TRACK = 'putRecordingTextTrack'; + public const SEND_CHAT_MESSAGE = 'sendChatMessage'; + public const GET_JOIN_URL = 'getJoinUrl'; + public const FEEDBACK = 'feedback'; public const HOOKS_CREATE = 'hooks/create'; public const HOOKS_LIST = 'hooks/list'; public const HOOKS_DESTROY = 'hooks/destroy'; diff --git a/src/Core/Attendee.php b/src/Core/Attendee.php index ac59be7a..1d306daa 100644 --- a/src/Core/Attendee.php +++ b/src/Core/Attendee.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,13 +20,15 @@ namespace BigBlueButton\Core; +use BigBlueButton\Enum\Role; + class Attendee { private string $userId; private string $fullName; - private string $role; + private Role $role; private bool $isPresenter; @@ -47,7 +49,7 @@ public function __construct(\SimpleXMLElement $xml) { $this->userId = $xml->userID->__toString(); $this->fullName = $xml->fullName->__toString(); - $this->role = $xml->role->__toString(); + $this->role = Role::from($xml->role->__toString()); $this->isPresenter = 'true' === $xml->isPresenter->__toString(); $this->isListeningOnly = 'true' === $xml->isListeningOnly->__toString(); $this->hasJoinedVoice = 'true' === $xml->hasJoinedVoice->__toString(); @@ -71,7 +73,7 @@ public function getFullName(): string return $this->fullName; } - public function getRole(): string + public function getRole(): Role { return $this->role; } diff --git a/src/Core/ClientSettingsOverride.php b/src/Core/ClientSettingsOverride.php new file mode 100644 index 00000000..f3b0e76e --- /dev/null +++ b/src/Core/ClientSettingsOverride.php @@ -0,0 +1,205 @@ +. + */ + +namespace BigBlueButton\Core; + +/** + * Class ClientSettingsOverride. + * + * Represents a client settings override module for BigBlueButton meetings. + * This allows overriding HTML5 client settings from the settings.yml file. + */ +class ClientSettingsOverride +{ + private array $settings = []; + + /** + * ClientSettingsOverride constructor. + * + * @param array $settings The settings to override + */ + public function __construct(array $settings = []) + { + $this->settings = $settings; + } + + /** + * Get all settings. + * + * @return array + */ + public function getSettings(): array + { + return $this->settings; + } + + /** + * Set all settings. + * + * @param array $settings + */ + public function setSettings(array $settings): self + { + $this->settings = $settings; + + return $this; + } + + /** + * Add or update a specific setting. + * + * @param string $key The setting key (supports dot notation like "public.kurento.wsUrl") + * @param mixed $value The setting value + */ + public function setSetting(string $key, mixed $value): self + { + $this->setNestedValue($this->settings, $key, $value); + + return $this; + } + + /** + * Get a specific setting. + * + * @param string $key The setting key (supports dot notation) + * @param mixed $default Default value if key doesn't exist + */ + public function getSetting(string $key, mixed $default = null): mixed + { + return $this->getNestedValue($this->settings, $key, $default); + } + + /** + * Remove a specific setting. + * + * @param string $key The setting key (supports dot notation) + */ + public function removeSetting(string $key): self + { + $this->removeNestedValue($this->settings, $key); + + return $this; + } + + /** + * Convert the settings to XML format for the BigBlueButton API. + * + * @return string The XML representation of the client settings override module + */ + public function toXML(): string + { + if (empty($this->settings)) { + return ''; + } + + $json = json_encode($this->settings, JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES); + + return << + + + + + XML; + } + + /** + * Create a ClientSettingsOverride instance from a JSON string. + * + * @param string $jsonString The JSON string containing settings + * + * @throws \InvalidArgumentException If the JSON is invalid + */ + public static function fromJson(string $jsonString): self + { + $settings = json_decode($jsonString, true); + + if (JSON_ERROR_NONE !== json_last_error()) { + throw new \InvalidArgumentException('Invalid JSON string: ' . json_last_error_msg()); + } + + return new self($settings); + } + + /** + * Set a nested value using dot notation. + */ + private function setNestedValue(array &$array, string $key, mixed $value): void + { + $keys = explode('.', $key); + $current = &$array; + + foreach ($keys as $i => $k) { + if ($i === count($keys) - 1) { + $current[$k] = $value; + break; + } + + if (!isset($current[$k]) || !is_array($current[$k])) { + $current[$k] = []; + } + + $current = &$current[$k]; + } + } + + /** + * Get a nested value using dot notation. + */ + private function getNestedValue(array $array, string $key, mixed $default = null): mixed + { + $keys = explode('.', $key); + $current = $array; + + foreach ($keys as $k) { + if (!is_array($current) || !array_key_exists($k, $current)) { + return $default; + } + + $current = $current[$k]; + } + + return $current; + } + + /** + * Remove a nested value using dot notation. + */ + private function removeNestedValue(array &$array, string $key): void + { + $keys = explode('.', $key); + $current = &$array; + + foreach ($keys as $i => $k) { + if ($i === count($keys) - 1) { + unset($current[$k]); + break; + } + + if (!is_array($current) || !array_key_exists($k, $current)) { + break; + } + + $current = &$current[$k]; + } + } +} diff --git a/src/Core/Document.php b/src/Core/Document.php new file mode 100644 index 00000000..c708871d --- /dev/null +++ b/src/Core/Document.php @@ -0,0 +1,115 @@ +. + */ + +namespace BigBlueButton\Core; + +abstract class Document implements DocumentInterface +{ + private ?string $name = null; + private ?bool $current = null; + private ?bool $downloadable = null; + private ?bool $removable = null; + private bool $validate = false; + + /** + * @var array + */ + private array $properties = []; + + final public function setName(?string $name): self + { + $this->name = $name; + + return $this; + } + + final public function getName(): ?string + { + return $this->name; + } + + final public function setCurrent(?bool $current): self + { + $this->current = $current; + + return $this; + } + + final public function isCurrent(): ?bool + { + return $this->current; + } + + final public function setDownloadable(?bool $downloadable): Document + { + $this->downloadable = $downloadable; + + return $this; + } + + final public function isDownloadable(): ?bool + { + return $this->downloadable; + } + + final public function setRemovable(?bool $removable): Document + { + $this->removable = $removable; + + return $this; + } + + final public function isRemovable(): ?bool + { + return $this->removable; + } + + /** + * Add additional properties to the document. These will be passed to the BBB-Server as + * attributes at the documents' XML-node. Not needed on standard implementation of a + * BBB-Server, but might be needed on customized (adapted) BBB-Server implementations. + */ + final public function addProperty(string $name, string $value): self + { + $this->properties[$name] = $value; + + return $this; + } + + /** + * @return array + */ + final public function getProperties(): array + { + return $this->properties; + } + + public function setValidation(bool $validation): Document + { + $this->validate = $validation; + + return $this; + } + + public function getValidation(): bool + { + return $this->validate; + } +} diff --git a/src/Core/DocumentFile.php b/src/Core/DocumentFile.php new file mode 100644 index 00000000..d2737214 --- /dev/null +++ b/src/Core/DocumentFile.php @@ -0,0 +1,80 @@ +. + */ + +namespace BigBlueButton\Core; + +class DocumentFile extends Document +{ + private string $filepath; + + /** @deprecated only needed until DocumentTrait::addPresentation() has not been removed */ + private ?string $fileContent = null; + + public function __construct(string $filepath, string $name) + { + $this->setFilepath($filepath); + $this->setName($name); + } + + public function setFilepath(string $filepath): self + { + $this->filepath = $filepath; + + return $this; + } + + public function getFilepath(): string + { + return $this->filepath; + } + + /** + * @deprecated only needed until DocumentTrait::addPresentation() has not been removed + */ + public function setFileContent(string $fileContent): self + { + $this->fileContent = $fileContent; + + return $this; + } + + /** + * @throws \Exception + */ + public function getFileContent(): string + { + if ($this->fileContent) { + return $this->fileContent; + } + + $fileContent = file_get_contents($this->filepath); + + if (!$fileContent) { + throw new \Exception("Unable to read file at {$this->filepath}"); + } + + return $fileContent; + } + + public function isValid(): bool + { + return file_exists($this->getFilepath()); + } +} diff --git a/src/Core/DocumentInterface.php b/src/Core/DocumentInterface.php new file mode 100644 index 00000000..c0acfcf3 --- /dev/null +++ b/src/Core/DocumentInterface.php @@ -0,0 +1,46 @@ +. + */ + +namespace BigBlueButton\Core; + +interface DocumentInterface +{ + public function setName(?string $name): Document; + + public function getName(): ?string; + + public function setCurrent(?bool $current): Document; + + public function isCurrent(): ?bool; + + public function setDownloadable(?bool $downloadable): Document; + + public function isDownloadable(): ?bool; + + public function setRemovable(?bool $removable): Document; + + public function isRemovable(): ?bool; + + public function isValid(): bool; + + public function setValidation(bool $validation): Document; + + public function getValidation(): bool; +} diff --git a/src/Core/DocumentUrl.php b/src/Core/DocumentUrl.php new file mode 100644 index 00000000..a2e514bc --- /dev/null +++ b/src/Core/DocumentUrl.php @@ -0,0 +1,100 @@ +. + */ + +namespace BigBlueButton\Core; + +class DocumentUrl extends Document +{ + private string $url; + + private int $timeout = 5; + + public function __construct(string $url, ?string $name = null) + { + $this->setUrl($url); + $this->setName($name); + } + + public function setUrl(string $url): self + { + $this->url = $url; + + return $this; + } + + public function getUrl(): string + { + return $this->url; + } + + public function setTimeout(int $timeout): self + { + $this->timeout = $timeout; + + return $this; + } + + public function getTimeout(): int + { + return $this->timeout; + } + + /** + * Checks the validity / existence of the provided URL. Pending on file size and server-performance + * the response could be slow. + * + * @experimental + */ + public function isValid(): bool + { + return $this->urlExists($this->getUrl()); + } + + /** + * Checks the validity / existence of the provided URL. Pending on file size and server-performance + * the response could be slow. + * + * @experimental + */ + private function urlExists(string $url): bool + { + $ch = curl_init($url); + + if (!$ch) { + throw new \RuntimeException('Unhandled curl error!'); + } + + curl_setopt($ch, CURLOPT_TIMEOUT, $this->getTimeout()); + curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $this->getTimeout()); + curl_setopt($ch, CURLOPT_NOBODY, true); + curl_setopt($ch, CURLOPT_RETURNTRANSFER, false); + + $data = curl_exec($ch); + $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); + + curl_close($ch); + + if ($httpCode >= 200 && $httpCode < 400) { + return true; + } + + return false; + } +} diff --git a/src/Core/Format.php b/src/Core/Format.php index 194a72c4..7c148f7f 100644 --- a/src/Core/Format.php +++ b/src/Core/Format.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Core/Hook.php b/src/Core/Hook.php index d340ed75..1e0b340a 100644 --- a/src/Core/Hook.php +++ b/src/Core/Hook.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -37,12 +37,18 @@ class Hook private bool $rawData; + /** + * @var array + */ + private array $eventID; + public function __construct(\SimpleXMLElement $xml) { $this->rawXml = $xml; $this->hookId = $xml->hookID->__toString(); $this->callbackUrl = $xml->callbackURL->__toString(); $this->meetingId = $xml->meetingID->__toString(); + $this->eventID = explode(',', $xml->eventID->__toString()); $this->permanentHook = 'true' === $xml->permanentHook->__toString(); $this->rawData = 'true' === $xml->rawData->__toString(); } @@ -62,6 +68,14 @@ public function getCallbackUrl(): string return $this->callbackUrl; } + /** + * @return array + */ + public function getEventID(): array + { + return $this->eventID; + } + public function isPermanentHook(): ?bool { return $this->permanentHook; diff --git a/src/Core/Image.php b/src/Core/Image.php index 205fff2e..d511227b 100644 --- a/src/Core/Image.php +++ b/src/Core/Image.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Core/Meeting.php b/src/Core/Meeting.php index 21283ba0..d29d8e1f 100644 --- a/src/Core/Meeting.php +++ b/src/Core/Meeting.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Core/Record.php b/src/Core/Record.php index db7f0970..858fd954 100644 --- a/src/Core/Record.php +++ b/src/Core/Record.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -29,9 +29,12 @@ class Record private string $recordId; private string $meetingId; + private string $internalMeetingID; private string $name; private bool $isPublished; private string $state; + private int $participants; + private int $rawSize; private float $startTime; private float $endTime; @@ -57,17 +60,20 @@ class Record public function __construct(\SimpleXMLElement $xml) { - $this->rawXml = $xml; - $this->recordId = $xml->recordID->__toString(); - $this->meetingId = $xml->meetingID->__toString(); - $this->name = $xml->name->__toString(); - $this->isPublished = 'true' === $xml->published->__toString(); - $this->state = $xml->state->__toString(); - $this->startTime = (float) $xml->startTime->__toString(); - $this->endTime = (float) $xml->endTime->__toString(); - $this->playbackType = $xml->playback->format->type->__toString(); - $this->playbackUrl = $xml->playback->format->url->__toString(); - $this->playbackLength = (int) $xml->playback->format->length->__toString(); + $this->rawXml = $xml; + $this->recordId = $xml->recordID->__toString(); + $this->meetingId = $xml->meetingID->__toString(); + $this->internalMeetingID = $xml->internalMeetingID->__toString(); + $this->name = $xml->name->__toString(); + $this->isPublished = 'true' === $xml->published->__toString(); + $this->state = $xml->state->__toString(); + $this->startTime = (float) $xml->startTime->__toString(); + $this->endTime = (float) $xml->endTime->__toString(); + $this->participants = (int) $xml->participants->__toString(); + $this->rawSize = (int) $xml->rawSize->__toString(); + $this->playbackType = $xml->playback->format->type->__toString(); + $this->playbackUrl = $xml->playback->format->url->__toString(); + $this->playbackLength = (int) $xml->playback->format->length->__toString(); foreach ($xml->metadata->children() as $meta) { $this->metas[$meta->getName()] = $meta->__toString(); @@ -84,6 +90,11 @@ public function getMeetingId(): string return $this->meetingId; } + public function getInternalMeetingID(): string + { + return $this->internalMeetingID; + } + public function getName(): string { return $this->name; @@ -109,6 +120,16 @@ public function getEndTime(): float return $this->endTime; } + public function getParticipants(): float + { + return $this->participants; + } + + public function getRawSize(): float + { + return $this->rawSize; + } + /** * @deprecated */ diff --git a/src/Core/Track.php b/src/Core/Track.php index d9f3ae1e..7a2c40b3 100644 --- a/src/Core/Track.php +++ b/src/Core/Track.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -35,10 +35,7 @@ class Track private string $source; - /** - * @param mixed $track - */ - public function __construct($track) + public function __construct(mixed $track) { $this->href = $track->href; $this->kind = $track->kind; diff --git a/src/Enum/DocumentOption.php b/src/Enum/DocumentOption.php index 51cf1370..cacab25d 100644 --- a/src/Enum/DocumentOption.php +++ b/src/Enum/DocumentOption.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,11 +20,9 @@ namespace BigBlueButton\Enum; -use MabeEnum\Enum; - -class DocumentOption extends Enum +enum DocumentOption: string { - public const CURRENT = 'current'; - public const DOWNLOADABLE = 'downloadable'; - public const REMOVABLE = 'removable'; + case CURRENT = 'current'; + case DOWNLOADABLE = 'downloadable'; + case REMOVABLE = 'removable'; } diff --git a/src/Enum/Feature.php b/src/Enum/Feature.php index 04ced411..b0a8cf12 100644 --- a/src/Enum/Feature.php +++ b/src/Enum/Feature.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,20 +20,37 @@ namespace BigBlueButton\Enum; -use MabeEnum\Enum; - -class Feature extends Enum +enum Feature: string { - public const BREAKOUT_ROOMS = 'breakoutRooms'; - public const CAPTIONS = 'captions'; - public const CHAT = 'chat'; - public const EXTERNAL_VIDEOS = 'externalVideos'; - public const LAYOUTS = 'layouts'; - public const LEARNING_DASHBOARD = 'learningDashboard'; - public const POLLS = 'polls'; - public const SCREENSHARE = 'screenshare'; - public const SHARED_NOTES = 'sharedNotes'; - public const VIRTUAL_BACKGROUNDS = 'virtualBackgrounds'; - public const LIVE_TRANSCRIPTION = 'liveTranscription'; - public const PRESENTATION = 'presentation'; + case BREAKOUT_ROOMS = 'breakoutRooms'; + case CAMERA_AS_CONTENT = 'cameraAsContent'; + case CAPTIONS = 'captions'; + case CHAT = 'chat'; + case CUSTOM_VIRTUAL_BACKGROUNDS = 'customVirtualBackgrounds'; + case DOWNLOAD_PRESENTATION_CONVERTED_TO_PDF = 'downloadPresentationConvertedToPdf'; + case DOWNLOAD_PRESENTATION_ORIGINAL_FILE = 'downloadPresentationOriginalFile'; + case DOWNLOAD_PRESENTATION_WITH_ANNOTATIONS = 'downloadPresentationWithAnnotations'; + case EXTERNAL_VIDEOS = 'externalVideos'; + case IMPORT_PRESENTATION_WITH_ANNOTATIONS_FROM_BREAKOUT_ROOMS = 'importPresentationWithAnnotationsFromBreakoutRooms'; + case IMPORT_SHARED_NOTES_FROM_BREAKOUT_ROOMS = 'importSharedNotesFromBreakoutRooms'; + case LAYOUTS = 'layouts'; + case LEARNING_DASHBOARD = 'learningDashboard'; + case LEARNING_DASHBOARD_DOWNLOAD_SESSION_DATA = 'learningDashboardDownloadSessionData'; + case LIVE_TRANSCRIPTION = 'liveTranscription'; + case POLLS = 'polls'; + case PRESENTATION = 'presentation'; + case SCREENSHARE = 'screenshare'; + case SHARED_NOTES = 'sharedNotes'; + case SNAPSHOT_OF_CURRENT_SLIDE = 'snapshotOfCurrentSlide'; + case TIMER = 'timer'; + case VIRTUAL_BACKGROUNDS = 'virtualBackgrounds'; + case INFINITE_WHITEBOARD = 'infiniteWhiteboard'; + case DELETE_CHAT_MESSAGE = 'deleteChatMessage'; + case EDIT_CHAT_MESSAGE = 'editChatMessage'; + case REPLY_CHAT_MESSAGE = 'replyChatMessage'; + case CHAT_MESSAGE_REACTIONS = 'chatMessageReactions'; + case RAISE_HAND = 'raiseHand'; + case USER_REACTIONS = 'userReactions'; + case CHAT_EMOJI_PICKET = 'chatEmojiPicker'; + case QUIZZES = 'quizzes'; } diff --git a/src/Enum/GuestPolicy.php b/src/Enum/GuestPolicy.php index 01d79b0d..586b49d6 100644 --- a/src/Enum/GuestPolicy.php +++ b/src/Enum/GuestPolicy.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,13 +20,13 @@ namespace BigBlueButton\Enum; -use MabeEnum\Enum; - -// @ref : https://github.com/bigbluebutton/bigbluebutton/blob/5189abb225247290d1954e10827853d5fc022b66/bbb-common-web/src/main/java/org/bigbluebutton/api/domain/GuestPolicy.java -class GuestPolicy extends Enum +/** + * @ref : https://github.com/bigbluebutton/bigbluebutton/blob/5189abb225247290d1954e10827853d5fc022b66/bbb-common-web/src/main/java/org/bigbluebutton/api/domain/GuestPolicy.java + */ +enum GuestPolicy: string { - public const ALWAYS_ACCEPT = 'ALWAYS_ACCEPT'; - public const ALWAYS_DENY = 'ALWAYS_DENY'; - public const ASK_MODERATOR = 'ASK_MODERATOR'; - public const ALWAYS_ACCEPT_AUTH = 'ALWAYS_ACCEPT_AUTH'; + case ALWAYS_ACCEPT = 'ALWAYS_ACCEPT'; + case ALWAYS_DENY = 'ALWAYS_DENY'; + case ASK_MODERATOR = 'ASK_MODERATOR'; + case ALWAYS_ACCEPT_AUTH = 'ALWAYS_ACCEPT_AUTH'; } diff --git a/src/Enum/HashingAlgorithm.php b/src/Enum/HashingAlgorithm.php index 326b5872..14d6863d 100644 --- a/src/Enum/HashingAlgorithm.php +++ b/src/Enum/HashingAlgorithm.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,10 @@ namespace BigBlueButton\Enum; -use MabeEnum\Enum; - -class HashingAlgorithm extends Enum +enum HashingAlgorithm: string { - public const SHA_1 = 'sha1'; - public const SHA_256 = 'sha256'; - public const SHA_512 = 'sha512'; - public const SHA_384 = 'sha384'; + case SHA_1 = 'sha1'; + case SHA_256 = 'sha256'; + case SHA_384 = 'sha384'; + case SHA_512 = 'sha512'; } diff --git a/src/Enum/MeetingLayout.php b/src/Enum/MeetingLayout.php index c13e680d..477b2266 100644 --- a/src/Enum/MeetingLayout.php +++ b/src/Enum/MeetingLayout.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,14 @@ namespace BigBlueButton\Enum; -use MabeEnum\Enum; - -class MeetingLayout extends Enum +enum MeetingLayout: string { - public const CUSTOM_LAYOUT = 'CUSTOM_LAYOUT'; - public const SMART_LAYOUT = 'SMART_LAYOUT'; - public const PRESENTATION_FOCUS = 'PRESENTATION_FOCUS'; - public const VIDEO_FOCUS = 'VIDEO_FOCUS'; + case CUSTOM_LAYOUT = 'CUSTOM_LAYOUT'; + case SMART_LAYOUT = 'SMART_LAYOUT'; + case PRESENTATION_FOCUS = 'PRESENTATION_FOCUS'; + case VIDEO_FOCUS = 'VIDEO_FOCUS'; + case CAMERAS_ONLY = 'CAMERAS_ONLY'; + case PARTICIPANTS_CHAT_ONLY = 'PARTICIPANTS_CHAT_ONLY'; + case PRESENTATION_ONLY = 'PRESENTATION_ONLY'; + case MEDIA_ONLY = 'MEDIA_ONLY'; } diff --git a/src/Enum/Role.php b/src/Enum/Role.php index a2d4246d..eab998b1 100644 --- a/src/Enum/Role.php +++ b/src/Enum/Role.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,10 +20,8 @@ namespace BigBlueButton\Enum; -use MabeEnum\Enum; - -class Role extends Enum +enum Role: string { - public const MODERATOR = 'MODERATOR'; - public const VIEWER = 'VIEWER'; + case MODERATOR = 'MODERATOR'; + case VIEWER = 'VIEWER'; } diff --git a/src/Enum/UserData.php b/src/Enum/UserData.php new file mode 100644 index 00000000..767b077d --- /dev/null +++ b/src/Enum/UserData.php @@ -0,0 +1,86 @@ +. + */ + +namespace BigBlueButton\Enum; + +enum UserData: string +{ + // Application settings + /** + * @deprecated since 3.0.0, no more available use "/api/feedback" instead. + */ + case ASK_FOR_FEEDBACK_ON_LOGOUT = 'bbb_ask_for_feedback_on_logout'; + case AUTO_JOIN_AUDIO = 'bbb_auto_join_audio'; + case CLIENT_TITLE = 'bbb_client_title'; + case FORCE_LISTEN_ONLY = 'bbb_force_listen_only'; + case LISTEN_ONLY_MODE = 'bbb_listen_only_mode'; + case SKIP_CHECK_AUDIO = 'bbb_skip_check_audio'; + case SKIP_CHECK_AUDIO_ON_FIRST_JOIN = 'bbb_skip_check_audio_on_first_join'; + case SKIP_ECHOTEST_IF_PREVIOUS_DEVICE = 'bbb_skip_echotest_if_previous_device'; + case OVERRIDE_DEFAULT_LOCALE = 'bbb_override_default_locale'; + case DIRECT_LEAVE_BUTTON = 'bbb_direct_leave_button'; + case PARENT_ROOM_MODERATOR = 'bbb_parent_room_moderator'; + case RECORD_PERMISSION = 'bbb_record_permission'; + case RECORD_PERMISSION_TOOLTIP = 'bbb_record_permission_tooltip'; + case SHOW_SESSION_DETAILS_ON_JOIN = 'bbb_show_session_details_on_join'; + // Branding settings + case DISPLAY_BRANDING_AREA = 'bbb_display_branding_area'; + + // Shortcut settings + case SHORTCUTS = 'bbb_shortcuts'; + + // Kurento settings (WebRTC media server) + case AUTO_SHARE_WEBCAM = 'bbb_auto_share_webcam'; + case PREFERRED_CAMERA_PROFILE = 'bbb_preferred_camera_profile'; + case ENABLE_VIDEO = 'bbb_enable_video'; + case RECORD_VIDEO = 'bbb_record_video'; + case SKIP_VIDEO_PREVIEW = 'bbb_skip_video_preview'; + case SKIP_VIDEO_PREVIEW_ON_FIRST_JOIN = 'bbb_skip_video_preview_on_first_join'; + case SKIP_VIDEO_PREVIEW_IF_PREVIOUS_DEVICE = 'bbb_skip_video_preview_if_previous_device'; + case MIRROR_OWN_WEBCAM = 'bbb_mirror_own_webcam'; + case FULLAUDIO_BRIDGE = 'bbb_fullaudio_bridge'; + case TRANSPARENT_LISTEN_ONLY = 'bbb_transparent_listen_only'; + + // Presentation settings + case FORCE_RESTORE_PRESENTATION_ON_NEW_EVENTS = 'bbb_force_restore_presentation_on_new_events'; + + // Whiteboard settings + case MULTI_USER_PEN_ONLY = 'bbb_multi_user_pen_only'; + case PRESENTER_TOOLS = 'bbb_presenter_tools'; + case MULTI_USER_TOOLS = 'bbb_multi_user_tools'; + case INITIAL_SELECTED_TOOL = 'bbb_initial_selected_tool'; + + // Theming & Styling settings + case CUSTOM_STYLE = 'bbb_custom_style'; + case CUSTOM_STYLE_URL = 'bbb_custom_style_url'; + case PREFER_DARK_THEME = 'bbb_prefer_dark_theme'; + + // Layout settings + case AUTO_SWAP_LAYOUT = 'bbb_auto_swap_layout'; + case HIDE_PRESENTATION = 'bbb_hide_presentation'; + case HIDE_PRESENTATION_ON_JOIN = 'bbb_hide_presentation_on_join'; + case SHOW_PARTICIPANTS_ON_LOGIN = 'bbb_show_participants_on_login'; + case SHOW_PUBLIC_CHAT_ON_LOGIN = 'bbb_show_public_chat_on_login'; + case HIDE_NAV_BAR = 'bbb_hide_nav_bar'; + case HIDE_ACTIONS_BAR = 'bbb_hide_actions_bar'; + case DEFAULT_LAYOUT = 'bbb_default_layout'; + case HIDE_NOTIFICATIONS = 'bbb_hide_notifications'; + case HIDE_CONTROLS = 'bbb_hide_controls'; +} diff --git a/src/Enum/WebHookEvent.php b/src/Enum/WebHookEvent.php new file mode 100644 index 00000000..d96c1dee --- /dev/null +++ b/src/Enum/WebHookEvent.php @@ -0,0 +1,70 @@ +. + */ + +namespace BigBlueButton\Enum; + +/** + * @ref : https://github.com/bigbluebutton/bbb-webhooks/blob/main/src/process/event.js#L7 + */ +enum WebHookEvent: string +{ + case MEETING_CREATED = 'meeting-created'; + case MEETING_ENDED = 'meeting-ended'; + case MEETING_RECORDING_STARTED = 'meeting-recording-started'; + case MEETING_RECORDING_STOPPED = 'meeting-recording-stopped'; + case MEETING_RECORDING_UNHANDLED = 'meeting-recording-unhandled'; + case MEETING_SCREENSHARE_STARTED = 'meeting-screenshare-started'; + case MEETING_SCREENSHARE_STOPPED = 'meeting-screenshare-stopped'; + case MEETING_PRESENTATION_CHANGED = 'meeting-presentation-changed'; + case USER_JOINED = 'user-joined'; + case USER_LEFT = 'user-left'; + case USER_AUDIO_VOICE_ENABLED = 'user-audio-voice-enabled'; + case USER_AUDIO_VOICE_DISABLED = 'user-audio-voice-disabled'; + case USER_AUDIO_MUTED = 'user-audio-muted'; + case USER_AUDIO_UNMUTED = 'user-audio-unmuted'; + case USER_AUDIO_UNHANDLED = 'user-audio-unhandled'; + case USER_CAM_BROADCAST_START = 'user-cam-broadcast-start'; + case USER_CAM_BROADCAST_END = 'user-cam-broadcast-end'; + case USER_PRESENTER_ASSIGNED = 'user-presenter-assigned'; + case USER_PRESENTER_UNASSIGNED = 'user-presenter-unassigned'; + case USER_EMOJI_CHANGED = 'user-emoji-changed'; + case USER_RAISE_HAND_CHANGED = 'user-raise-hand-changed'; + case CHAT_GROUP_MESSAGE_SENT = 'chat-group-message-sent'; + case RAP_PUBLISHED = 'rap-published'; + case RAP_UNPUBLISHED = 'rap-unpublished'; + case RAP_DELETED = 'rap-deleted'; + case PAD_CONTENT = 'pad-content'; + case RAP_ARCHIVE_STARTED = 'rap-archive-started'; + case RAP_ARCHIVE_ENDED = 'rap-archive-ended'; + case RAP_SANITY_STARTED = 'rap-sanity-started'; + case RAP_SANITY_ENDED = 'rap-sanity-ended'; + case RAP_POST_ARCHIVE_STARTED = 'rap-post-archive-started'; + case RAP_POST_ARCHIVE_ENDED = 'rap-post-archive-ended'; + case RAP_PROCESS_STARTED = 'rap-process-started'; + case RAP_PROCESS_ENDED = 'rap-process-ended'; + case RAP_POST_PROCESS_STARTED = 'rap-post-process-started'; + case RAP_POST_PROCESS_ENDED = 'rap-post-process-ended'; + case RAP_PUBLISH_STARTED = 'rap-publish-started'; + case RAP_PUBLISH_ENDED = 'rap-publish-ended'; + case RAP_POST_PUBLISH_STARTED = 'rap-post-publish-started'; + case RAP_POST_PUBLISH_ENDED = 'rap-post-publish-ended'; + case POLL_STARTED = 'poll-started'; + case POLL_RESPONDED = 'poll-responded'; +} diff --git a/src/Exceptions/BadResponseException.php b/src/Exceptions/BadResponseException.php index 9628989c..612be6be 100644 --- a/src/Exceptions/BadResponseException.php +++ b/src/Exceptions/BadResponseException.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Parameters/BaseParameters.php b/src/Parameters/BaseParameters.php index 12b7da5c..3af1c317 100644 --- a/src/Parameters/BaseParameters.php +++ b/src/Parameters/BaseParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,18 +20,120 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class BaseParameters. */ abstract class BaseParameters { - abstract public function getHTTPQuery(): string; + public function getHTTPQuery(): string + { + $apiData = $this->toApiDataArray(); + + // No need for null checks anymore since toApiDataArray() filters them out + foreach ($apiData as $value) { + if (!is_string($value)) { + throw new \RuntimeException(sprintf('Invalid API parameter type: %s', gettype($value))); + } + } + + return $this->buildHTTPQuery($apiData); + } + + /** + * @return array // Keys are strings, values are strings or null + */ + public function toApiDataArray(): array + { + $result = []; + $classReflection = new \ReflectionClass($this); + + foreach ($classReflection->getMethods() as $method) { + foreach ($method->getAttributes(ApiParameterMapper::class) as $attribute) { + /** @var ApiParameterMapper $attributeObject */ + $attributeObject = $attribute->newInstance(); + $key = $attributeObject->getAttributeName(); + $value = $this->strictConvertToApiValue($this->{$method->getName()}()); + + // Only include non-null values + if (null !== $value) { + $result[$key] = $value; + } + } + } + + return $result; + } + + /** + * @param array $array // Keys and values are both strings + */ + protected function buildHTTPQuery(array $array): string + { + return str_replace( + ['%20', '!', "'", '(', ')', '*'], + ['+', '%21', '%27', '%28', '%29', '%2A'], + http_build_query($array, '', '&', \PHP_QUERY_RFC3986) + ); + } + + /** + * Converts any value to API string format with strict type enforcement. + * + * @param mixed $value + */ + private function strictConvertToApiValue($value): ?string + { + if (null === $value) { + return null; + } + + // Handle BackedEnum cases + if ($value instanceof \BackedEnum) { + $enumValue = $value->value; + + if (!is_scalar($enumValue)) { + throw new \RuntimeException(sprintf('Enum value for %s must be scalar, got %s', get_class($value), gettype($enumValue))); + } + + return (string) $enumValue; + } + + // Handle arrays + if (is_array($value)) { + return $this->convertArrayToApiString($value); + } + + // Handle all other cases with strict string conversion + if (is_bool($value)) { + return $value ? 'true' : 'false'; + } + + if (is_object($value)) { + throw new \RuntimeException(sprintf('Cannot convert object of type %s to API value', get_class($value))); + } + + // Force string conversion for all scalar values + return (string) $value; + } /** - * @param mixed $array + * Converts array values to comma-separated string with strict typing. + * + * @param array $values // Array of mixed values that will be converted */ - protected function buildHTTPQuery($array): string + private function convertArrayToApiString(array $values): string { - return str_replace(['%20', '!', "'", '(', ')', '*'], ['+', '%21', '%27', '%28', '%29', '%2A'], http_build_query(array_filter($array), '', '&', \PHP_QUERY_RFC3986)); + $converted = []; + foreach ($values as $item) { + $convertedItem = $this->strictConvertToApiValue($item); + + if (null !== $convertedItem) { + $converted[] = $convertedItem; + } + } + + return implode(',', $converted); } } diff --git a/src/Parameters/Config/DocumentOptions.php b/src/Parameters/Config/DocumentOptions.php new file mode 100644 index 00000000..e8db4ebd --- /dev/null +++ b/src/Parameters/Config/DocumentOptions.php @@ -0,0 +1,47 @@ +. + */ + +namespace BigBlueButton\Parameters\Config; + +use BigBlueButton\Enum\DocumentOption; + +/** + * @deprecated Replaced by new Document-class, DocumentUrl-class and DocumentFile-class + */ +class DocumentOptions +{ + /** @var array */ + private array $documentOptions = []; + + public function addOption(DocumentOption $documentOption, bool $value): self + { + $this->documentOptions[$documentOption->value] = $value; + + return $this; + } + + /** + * @return array + */ + public function getOptions(): array + { + return $this->documentOptions; + } +} diff --git a/src/Parameters/CreateMeetingParameters.php b/src/Parameters/CreateMeetingParameters.php index 00d9be6d..a415b50f 100644 --- a/src/Parameters/CreateMeetingParameters.php +++ b/src/Parameters/CreateMeetingParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,6 +20,12 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; +use BigBlueButton\Core\ClientSettingsOverride; +use BigBlueButton\Enum\Feature; +use BigBlueButton\Enum\GuestPolicy; +use BigBlueButton\Enum\MeetingLayout; + /** * Class CreateMeetingParameters. */ @@ -27,9 +33,9 @@ class CreateMeetingParameters extends MetaParameters { use DocumentableTrait; - private ?string $meetingId = null; + private string $meetingId; - private ?string $meetingName = null; + private string $meetingName; /** * @deprecated Password-string replaced by an Enum\Role-constant in JoinMeetingParameters::__construct() @@ -79,7 +85,7 @@ class CreateMeetingParameters extends MetaParameters private ?bool $lockSettingsDisablePublicChat = null; - private ?bool $lockSettingsDisableNote = null; + private ?bool $lockSettingsDisableNotes = null; private ?bool $lockSettingsHideUserList = null; @@ -105,7 +111,7 @@ class CreateMeetingParameters extends MetaParameters private ?bool $freeJoin = null; - private ?string $guestPolicy = null; + private ?GuestPolicy $guestPolicy = null; private ?string $bannerText = null; @@ -140,7 +146,7 @@ class CreateMeetingParameters extends MetaParameters private ?string $meetingEndedURL = null; - private ?string $meetingLayout = null; + private ?MeetingLayout $meetingLayout = null; private ?int $userCameraCap = null; @@ -150,15 +156,19 @@ class CreateMeetingParameters extends MetaParameters private ?int $meetingExpireWhenLastUserLeftInMinutes = null; + private ?string $preUploadedPresentation = null; + + private ?string $preUploadedPresentationName = null; + private ?bool $preUploadedPresentationOverrideDefault = null; /** - * @var array + * @var Feature[] */ private array $disabledFeatures = []; /** - * @var array + * @var Feature[] */ private array $disabledFeaturesExclude = []; @@ -175,18 +185,35 @@ class CreateMeetingParameters extends MetaParameters private ?string $presentationUploadExternalDescription = null; + private ?bool $allowPromoteGuestToModerator = null; + + private ?bool $allowOverrideClientSettingsOnCreateCall = null; + + private ?ClientSettingsOverride $clientSettingsOverride = null; + + private ?string $loginURL = null; + + // New properties + private ?string $pluginManifests = null; + + private ?string $pluginManifestsFetchUrl = null; + + private ?bool $presentationConversionCacheEnabled = null; + + private ?int $maxNumPages = null; + + private ?bool $multiUserWhiteboardEnabled = null; + /** * CreateMeetingParameters constructor. - * - * @param mixed $meetingId - * @param mixed $meetingName */ - public function __construct($meetingId = null, $meetingName = null) + public function __construct(string $meetingId, string $meetingName) { $this->meetingId = $meetingId; $this->meetingName = $meetingName; } + #[ApiParameterMapper(attributeName: 'meetingID')] public function getMeetingId(): ?string { return $this->meetingId; @@ -213,6 +240,7 @@ public function setMeetingId(string $meetingId): self return $this; } + #[ApiParameterMapper(attributeName: 'name')] public function getMeetingName(): ?string { return $this->meetingName; @@ -231,6 +259,7 @@ public function setMeetingName(string $meetingName): self /** * @deprecated Password-string replaced by an Enum\Role-constant in JoinMeetingParameters::__construct() */ + #[ApiParameterMapper(attributeName: 'attendeePW')] public function getAttendeePassword(): ?string { return $this->attendeePassword; @@ -253,6 +282,7 @@ public function setAttendeePassword(string $attendeePassword): self /** * @deprecated Password-string replaced by an Enum\Role-constant in JoinMeetingParameters::__construct() */ + #[ApiParameterMapper(attributeName: 'moderatorPW')] public function getModeratorPassword(): ?string { return $this->moderatorPassword; @@ -272,6 +302,7 @@ public function setModeratorPassword(string $moderatorPassword): self return $this; } + #[ApiParameterMapper(attributeName: 'dialNumber')] public function getDialNumber(): ?string { return $this->dialNumber; @@ -288,6 +319,7 @@ public function setDialNumber(string $dialNumber): self return $this; } + #[ApiParameterMapper(attributeName: 'voiceBridge')] public function getVoiceBridge(): ?int { return $this->voiceBridge; @@ -315,6 +347,7 @@ public function setVoiceBridge(int $voiceBridge): self return $this; } + #[ApiParameterMapper(attributeName: 'webVoice')] public function getWebVoice(): ?string { return $this->webVoice; @@ -327,6 +360,7 @@ public function setWebVoice(string $webVoice): self return $this; } + #[ApiParameterMapper(attributeName: 'logoutURL')] public function getLogoutUrl(): ?string { return $this->logoutUrl; @@ -343,6 +377,7 @@ public function setLogoutUrl(string $logoutUrl): self return $this; } + #[ApiParameterMapper(attributeName: 'maxParticipants')] public function getMaxParticipants(): ?int { return $this->maxParticipants; @@ -358,6 +393,7 @@ public function setMaxParticipants(int $maxParticipants): self return $this; } + #[ApiParameterMapper(attributeName: 'record')] public function isRecorded(): ?bool { return $this->record; @@ -379,6 +415,7 @@ public function setRecord(bool $record): self return $this; } + #[ApiParameterMapper(attributeName: 'autoStartRecording')] public function isAutoStartRecording(): ?bool { return $this->autoStartRecording; @@ -400,6 +437,7 @@ public function setAutoStartRecording(bool $autoStartRecording): self return $this; } + #[ApiParameterMapper(attributeName: 'allowStartStopRecording')] public function isAllowStartStopRecording(): ?bool { return $this->allowStartStopRecording; @@ -418,6 +456,7 @@ public function setAllowStartStopRecording(bool $allowStartStopRecording): self return $this; } + #[ApiParameterMapper(attributeName: 'duration')] public function getDuration(): ?int { return $this->duration; @@ -441,6 +480,7 @@ public function setDuration(int $duration): self return $this; } + #[ApiParameterMapper(attributeName: 'welcome')] public function getWelcomeMessage(): ?string { return $this->welcomeMessage; @@ -459,6 +499,7 @@ public function setWelcomeMessage(string $welcomeMessage): self return $this; } + #[ApiParameterMapper(attributeName: 'moderatorOnlyMessage')] public function getModeratorOnlyMessage(): ?string { return $this->moderatorOnlyMessage; @@ -476,6 +517,7 @@ public function setModeratorOnlyMessage(string $message): self return $this; } + #[ApiParameterMapper(attributeName: 'webcamsOnlyForModerator')] public function isWebcamsOnlyForModerator(): ?bool { return $this->webcamsOnlyForModerator; @@ -494,6 +536,7 @@ public function setWebcamsOnlyForModerator(bool $webcamsOnlyForModerator): self return $this; } + #[ApiParameterMapper(attributeName: 'logo')] public function getLogo(): ?string { return $this->logo; @@ -510,6 +553,7 @@ public function setLogo(string $logo): self return $this; } + #[ApiParameterMapper(attributeName: 'bannerText')] public function getBannerText(): ?string { return $this->bannerText; @@ -527,6 +571,7 @@ public function setBannerText(string $bannerText): self return $this; } + #[ApiParameterMapper(attributeName: 'bannerColor')] public function getBannerColor(): ?string { return $this->bannerColor; @@ -547,6 +592,7 @@ public function setBannerColor(string $bannerColor): self /** * @deprecated Removed in 2.5, temporarily still handled, please transition to disabledFeatures. */ + #[ApiParameterMapper(attributeName: 'learningDashboardEnabled')] public function isLearningDashboardEnabled(): ?bool { return $this->learningDashboardEnabled; @@ -571,6 +617,7 @@ public function setLearningDashboardEnabled(bool $learningDashboardEnabled): sel /** * @deprecated Removed in 2.5, temporarily still handled, please transition to disabledFeatures. */ + #[ApiParameterMapper(attributeName: 'virtualBackgroundsDisabled')] public function isVirtualBackgroundsDisabled(): ?bool { return $this->virtualBackgroundsDisabled; @@ -582,12 +629,9 @@ public function isVirtualBackgroundsDisabled(): ?bool * Default: false * * @since 2.4.3 - * - * @param mixed $virtualBackgroundsDisabled - * * @deprecated Removed in 2.5, temporarily still handled, please transition to disabledFeatures. */ - public function setVirtualBackgroundsDisabled($virtualBackgroundsDisabled): self + public function setVirtualBackgroundsDisabled(bool $virtualBackgroundsDisabled): self { $this->virtualBackgroundsDisabled = $virtualBackgroundsDisabled; @@ -615,6 +659,7 @@ public function setLearningDashboardCleanupDelayInMinutes(int $learningDashboard return $this; } + #[ApiParameterMapper(attributeName: 'endWhenNoModeratorDelayInMinutes')] public function getEndWhenNoModeratorDelayInMinutes(): ?int { return $this->endWhenNoModeratorDelayInMinutes; @@ -635,6 +680,7 @@ public function setEndWhenNoModeratorDelayInMinutes(int $endWhenNoModeratorDelay return $this; } + #[ApiParameterMapper(attributeName: 'endWhenNoModerator')] public function isEndWhenNoModerator(): ?bool { return $this->endWhenNoModerator; @@ -655,6 +701,7 @@ public function setEndWhenNoModerator(bool $endWhenNoModerator): self return $this; } + #[ApiParameterMapper(attributeName: 'meetingKeepEvents')] public function isMeetingKeepEvents(): ?bool { return $this->meetingKeepEvents; @@ -675,6 +722,7 @@ public function setMeetingKeepEvents(bool $meetingKeepEvents): self return $this; } + #[ApiParameterMapper(attributeName: 'copyright')] public function getCopyright(): ?string { return $this->copyright; @@ -687,6 +735,7 @@ public function setCopyright(string $copyright): self return $this; } + #[ApiParameterMapper(attributeName: 'muteOnStart')] public function isMuteOnStart(): ?bool { return $this->muteOnStart; @@ -704,6 +753,7 @@ public function setMuteOnStart(bool $muteOnStart): self return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsDisableCam')] public function isLockSettingsDisableCam(): ?bool { return $this->lockSettingsDisableCam; @@ -723,6 +773,7 @@ public function setLockSettingsDisableCam(bool $lockSettingsDisableCam): self return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsDisableMic')] public function isLockSettingsDisableMic(): ?bool { return $this->lockSettingsDisableMic; @@ -742,6 +793,7 @@ public function setLockSettingsDisableMic(bool $lockSettingsDisableMic): self return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsDisablePrivateChat')] public function isLockSettingsDisablePrivateChat(): ?bool { return $this->lockSettingsDisablePrivateChat; @@ -761,6 +813,7 @@ public function setLockSettingsDisablePrivateChat(bool $lockSettingsDisablePriva return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsDisablePublicChat')] public function isLockSettingsDisablePublicChat(): ?bool { return $this->lockSettingsDisablePublicChat; @@ -780,9 +833,30 @@ public function setLockSettingsDisablePublicChat(bool $lockSettingsDisablePublic return $this; } + /** + * @deprecated isLockSettingsDisableNote is replaced by isLockSettingsDisableNotes + */ public function isLockSettingsDisableNote(): ?bool { - return $this->lockSettingsDisableNote; + return $this->isLockSettingsDisableNotes(); + } + + /** + * Setting to true will disable notes in the meeting. + * + * @deprecated setLockSettingsDisableNote is replaced by setLockSettingsDisableNotes + */ + public function setLockSettingsDisableNote(bool $lockSettingsDisableNote): self + { + $this->setLockSettingsDisableNotes($lockSettingsDisableNote); + + return $this; + } + + #[ApiParameterMapper(attributeName: 'lockSettingsDisableNotes')] + public function isLockSettingsDisableNotes(): ?bool + { + return $this->lockSettingsDisableNotes; } /** @@ -792,13 +866,14 @@ public function isLockSettingsDisableNote(): ?bool * * @since 2.2 */ - public function setLockSettingsDisableNote(bool $lockSettingsDisableNote): self + public function setLockSettingsDisableNotes(bool $lockSettingsDisableNotes): self { - $this->lockSettingsDisableNote = $lockSettingsDisableNote; + $this->lockSettingsDisableNotes = $lockSettingsDisableNotes; return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsHideUserList')] public function isLockSettingsHideUserList(): ?bool { return $this->lockSettingsHideUserList; @@ -818,6 +893,7 @@ public function setLockSettingsHideUserList(bool $lockSettingsHideUserList): sel return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsLockedLayout')] public function isLockSettingsLockedLayout(): ?bool { return $this->lockSettingsLockedLayout; @@ -830,6 +906,7 @@ public function setLockSettingsLockedLayout(bool $lockSettingsLockedLayout): sel return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsLockOnJoin')] public function isLockSettingsLockOnJoin(): ?bool { return $this->lockSettingsLockOnJoin; @@ -849,6 +926,7 @@ public function setLockSettingsLockOnJoin(bool $lockOnJoin): self return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsLockOnJoinConfigurable')] public function isLockSettingsLockOnJoinConfigurable(): ?bool { return $this->lockSettingsLockOnJoinConfigurable; @@ -866,6 +944,7 @@ public function setLockSettingsLockOnJoinConfigurable(bool $lockOnJoinConfigurab return $this; } + #[ApiParameterMapper(attributeName: 'lockSettingsHideViewersCursor')] public function isLockSettingsHideViewersCursor(): ?bool { return $this->lockSettingsHideViewersCursor; @@ -885,6 +964,7 @@ public function setLockSettingsHideViewersCursor(bool $lockSettingsHideViewersCu return $this; } + #[ApiParameterMapper(attributeName: 'allowModsToUnmuteUsers')] public function isAllowModsToUnmuteUsers(): ?bool { return $this->allowModsToUnmuteUsers; @@ -904,6 +984,7 @@ public function setAllowModsToUnmuteUsers(bool $allowModsToUnmuteUsers): self return $this; } + #[ApiParameterMapper(attributeName: 'allowModsToEjectCameras')] public function isAllowModsToEjectCameras(): ?bool { return $this->allowModsToEjectCameras; @@ -926,6 +1007,7 @@ public function setAllowModsToEjectCameras(bool $allowModsToEjectCameras): self /** * @param mixed $endCallbackUrl */ + // #[ApiParameterMapper(attributeName: 'endCallbackUrl')] public function setEndCallbackUrl($endCallbackUrl): self { $this->addMeta('endCallbackUrl', $endCallbackUrl); @@ -1003,7 +1085,8 @@ public function setFreeJoin(bool $freeJoin): self return $this; } - public function getGuestPolicy(): ?string + #[ApiParameterMapper(attributeName: 'guestPolicy')] + public function getGuestPolicy(): ?GuestPolicy { return $this->guestPolicy; } @@ -1015,7 +1098,7 @@ public function getGuestPolicy(): ?string * * Default: ALWAYS_ACCEPT */ - public function setGuestPolicy(string $guestPolicy): self + public function setGuestPolicy(GuestPolicy $guestPolicy): self { $this->guestPolicy = $guestPolicy; @@ -1025,6 +1108,7 @@ public function setGuestPolicy(string $guestPolicy): self /** * @deprecated Removed in 2.5, temporarily still handled, please transition to disabledFeatures. */ + #[ApiParameterMapper(attributeName: 'breakoutRoomsEnabled')] public function isBreakoutRoomsEnabled(): ?bool { return $this->breakoutRoomsEnabled; @@ -1046,6 +1130,7 @@ public function setBreakoutRoomsEnabled($breakoutRoomsEnabled): self return $this; } + #[ApiParameterMapper(attributeName: 'breakoutRoomsRecord')] public function isBreakoutRoomsRecord(): ?bool { return $this->breakoutRoomsRecord; @@ -1063,6 +1148,7 @@ public function setBreakoutRoomsRecord(bool $breakoutRoomsRecord): self return $this; } + #[ApiParameterMapper(attributeName: 'breakoutRoomsPrivateChatEnabled')] public function isBreakoutRoomsPrivateChatEnabled(): ?bool { return $this->breakoutRoomsPrivateChatEnabled; @@ -1080,6 +1166,7 @@ public function setBreakoutRoomsPrivateChatEnabled(bool $breakoutRoomsPrivateCha return $this; } + #[ApiParameterMapper(attributeName: 'meetingEndedURL')] public function getMeetingEndedURL(): ?string { return $this->meetingEndedURL; @@ -1092,26 +1179,28 @@ public function setMeetingEndedURL(string $meetingEndedURL): self return $this; } - public function getMeetingLayout(): ?string + #[ApiParameterMapper(attributeName: 'meetingLayout')] + public function getMeetingLayout(): ?MeetingLayout { return $this->meetingLayout; } /** * Will set the default layout for the meeting. Possible values are: CUSTOM_LAYOUT, SMART_LAYOUT, - * PRESENTATION_FOCUS, VIDEO_FOCUS. + * PRESENTATION_FOCUS, VIDEO_FOCUS, CAMERAS_ONLY, PARTICIPANTS_CHAT_ONLY, PRESENTATION_ONLY, MEDIA_ONLY. * * Default: SMART_LAYOUT * * @since 2.4 */ - public function setMeetingLayout(string $meetingLayout): self + public function setMeetingLayout(MeetingLayout $meetingLayout): self { $this->meetingLayout = $meetingLayout; return $this; } + #[ApiParameterMapper(attributeName: 'allowRequestsWithoutSession')] public function isAllowRequestsWithoutSession(): ?bool { return $this->allowRequestsWithoutSession; @@ -1133,6 +1222,7 @@ public function setAllowRequestsWithoutSession($allowRequestsWithoutSession): se return $this; } + #[ApiParameterMapper(attributeName: 'userCameraCap')] public function getUserCameraCap(): ?int { return $this->userCameraCap; @@ -1153,6 +1243,7 @@ public function setUserCameraCap(int $userCameraCap): self return $this; } + #[ApiParameterMapper(attributeName: 'meetingCameraCap')] public function getMeetingCameraCap(): ?int { return $this->meetingCameraCap; @@ -1173,6 +1264,7 @@ public function setMeetingCameraCap(int $meetingCameraCap): self return $this; } + #[ApiParameterMapper(attributeName: 'meetingExpireIfNoUserJoinedInMinutes')] public function getMeetingExpireIfNoUserJoinedInMinutes(): ?int { return $this->meetingExpireIfNoUserJoinedInMinutes; @@ -1192,6 +1284,7 @@ public function setMeetingExpireIfNoUserJoinedInMinutes(int $meetingExpireIfNoUs return $this; } + #[ApiParameterMapper(attributeName: 'meetingExpireWhenLastUserLeftInMinutes')] public function getMeetingExpireWhenLastUserLeftInMinutes(): ?int { return $this->meetingExpireWhenLastUserLeftInMinutes; @@ -1213,11 +1306,61 @@ public function setMeetingExpireWhenLastUserLeftInMinutes(int $meetingExpireWhen return $this; } + #[ApiParameterMapper(attributeName: 'preUploadedPresentationOverrideDefault')] public function isPreUploadedPresentationOverrideDefault(): ?bool { return $this->preUploadedPresentationOverrideDefault; } + #[ApiParameterMapper(attributeName: 'allowPromoteGuestToModerator')] + public function isAllowPromoteGuestToModerator(): ?bool + { + return $this->allowPromoteGuestToModerator; + } + + #[ApiParameterMapper(attributeName: 'allowOverrideClientSettingsOnCreateCall')] + public function isAllowOverrideClientSettingsOnCreateCall(): ?bool + { + return $this->allowOverrideClientSettingsOnCreateCall; + } + + /** + * If passed with a valid presentation file url, this presentation will override the default presentation. + * To only upload but not set as default, also pass preUploadedPresentationOverrideDefault=false. + * + * @since 2.7.2 + */ + public function setPreUploadedPresentation(string $preUploadedPresentation): self + { + $this->preUploadedPresentation = $preUploadedPresentation; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'preUploadedPresentation')] + public function getPreUploadedPresentation(): ?string + { + return $this->preUploadedPresentation; + } + + /** + * If passed it will use this string as the name of the presentation uploaded via preUploadedPresentation. + * + * @since 2.7.2 + */ + public function setPreUploadedPresentationName(string $preUploadedPresentationName): self + { + $this->preUploadedPresentationName = $preUploadedPresentationName; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'preUploadedPresentationName')] + public function getPreUploadedPresentationName(): ?string + { + return $this->preUploadedPresentationName; + } + /** * If it is true, the default.pdf document is not sent along with the other presentations in the /create * endpoint, on the other hand, if that's false, the default.pdf is sent with the other documents. @@ -1232,8 +1375,123 @@ public function setPreUploadedPresentationOverrideDefault(bool $preUploadedPrese } /** - * @return array + * @since 2.7.9 + */ + public function setAllowPromoteGuestToModerator(bool $allowPromoteGuestToModerator): self + { + $this->allowPromoteGuestToModerator = $allowPromoteGuestToModerator; + + return $this; + } + + /** + * @since 3.0.0 + */ + public function setAllowOverrideClientSettingsOnCreateCall(bool $allowOverrideClientSettingsOnCreateCall): self + { + $this->allowOverrideClientSettingsOnCreateCall = $allowOverrideClientSettingsOnCreateCall; + + return $this; + } + + public function getClientSettingsOverride(): ?ClientSettingsOverride + { + return $this->clientSettingsOverride; + } + + /** + * Set the client settings override module for the meeting. + * This allows overriding HTML5 client settings from the settings.yml file. + * + * Note: This requires allowOverrideClientSettingsOnCreateCall to be set to true. + * + * @since 3.0.0 + */ + public function setClientSettingsOverride(?ClientSettingsOverride $clientSettingsOverride): self + { + $this->clientSettingsOverride = $clientSettingsOverride; + + return $this; + } + + /** + * Get the client settings override as XML for the API request. + * + * @return string The XML representation of the client settings override module + * + * @since 3.0.0 + */ + public function getClientSettingsOverrideAsXML(): string + { + if (null === $this->clientSettingsOverride) { + return ''; + } + + return $this->clientSettingsOverride->toXML(); + } + + /** + * Get all modules (presentations and client settings override) as combined XML for the API request. + * + * @return string The combined XML representation of all modules + * + * @since 3.0.0 */ + public function getModulesAsXML(): string + { + $presentationsXml = $this->getPresentationsAsXML(); + $clientSettingsXml = $this->getClientSettingsOverrideAsXML(); + + // If both are empty, return empty string + if (empty($presentationsXml) && empty($clientSettingsXml)) { + return ''; + } + + // If only one is present, return it directly + if (empty($presentationsXml)) { + return $clientSettingsXml; + } + + if (empty($clientSettingsXml)) { + return $presentationsXml; + } + + // Both are present, need to merge them + try { + $presentationsDom = new \DOMDocument(); + $presentationsDom->loadXML($presentationsXml); + + $clientSettingsDom = new \DOMDocument(); + $clientSettingsDom->loadXML($clientSettingsXml); + + // Get the modules element from presentations + $presentationsModules = $presentationsDom->getElementsByTagName('modules')->item(0); + $clientSettingsModules = $clientSettingsDom->getElementsByTagName('modules')->item(0); + + if ($presentationsModules && $clientSettingsModules) { + // Import all modules from client settings into presentations + foreach ($clientSettingsModules->childNodes as $childNode) { + if (XML_ELEMENT_NODE === $childNode->nodeType) { + $importedNode = $presentationsDom->importNode($childNode, true); + $presentationsModules->appendChild($importedNode); + } + } + + return $presentationsDom->saveXML(); + } + + // Fallback: return presentations XML if something goes wrong + return $presentationsXml; + } catch (\Exception $e) { + // If XML parsing fails, return presentations XML as fallback + return $presentationsXml; + } + } + + /** + * @return Feature[] + */ + #[ApiParameterMapper(attributeName: 'disabledFeatures')] public function getDisabledFeatures(): array { return $this->disabledFeatures; @@ -1263,7 +1521,7 @@ public function getDisabledFeatures(): array * - cameraAsContent: Enables/Disables camera as a content * - timer: Disables timer * - * @param array $disabledFeatures + * @param Feature[] $disabledFeatures * * @since 2.5 */ @@ -1275,8 +1533,9 @@ public function setDisabledFeatures(array $disabledFeatures): self } /** - * @return array + * @return Feature[] */ + #[ApiParameterMapper(attributeName: 'disabledFeaturesExclude')] public function getDisabledFeaturesExclude(): array { return $this->disabledFeaturesExclude; @@ -1289,7 +1548,7 @@ public function getDisabledFeaturesExclude(): array * * The available options to exclude are exactly the same as for disabledFeatures * - * @param array $disabledFeaturesExclude + * @param Feature[] $disabledFeaturesExclude * * @since 2.6.9 */ @@ -1300,6 +1559,7 @@ public function setDisabledFeaturesExclude(array $disabledFeaturesExclude): self return $this; } + #[ApiParameterMapper(attributeName: 'recordFullDurationMedia')] public function getRecordFullDurationMedia(): ?bool { return $this->recordFullDurationMedia; @@ -1330,17 +1590,16 @@ public function getBreakoutRoomsGroups(): array } /** - * @param mixed $id - * @param mixed $name - * @param mixed $roster + * @param array $roster */ - public function addBreakoutRoomsGroup($id, $name, $roster): self + public function addBreakoutRoomsGroup(mixed $id, string $name, array $roster): self { $this->breakoutRoomsGroups[] = ['id' => $id, 'name' => $name, 'roster' => $roster]; return $this; } + #[ApiParameterMapper(attributeName: 'notifyRecordingIsOn')] public function getNotifyRecordingIsOn(): ?bool { return $this->notifyRecordingIsOn; @@ -1361,6 +1620,7 @@ public function setNotifyRecordingIsOn(bool $notifyRecordingIsOn): self return $this; } + #[ApiParameterMapper(attributeName: 'presentationUploadExternalUrl')] public function getPresentationUploadExternalUrl(): ?string { return $this->presentationUploadExternalUrl; @@ -1379,6 +1639,7 @@ public function setPresentationUploadExternalUrl(string $presentationUploadExter return $this; } + #[ApiParameterMapper(attributeName: 'presentationUploadExternalDescription')] public function getPresentationUploadExternalDescription(): ?string { return $this->presentationUploadExternalDescription; @@ -1397,66 +1658,112 @@ public function setPresentationUploadExternalDescription(string $presentationUpl return $this; } + #[ApiParameterMapper(attributeName: 'loginURL')] + public function getLoginURL(): ?string + { + return $this->loginURL; + } + + /** + * @since 3.0.0 + */ + public function setLoginURL(string $loginURL): self + { + $this->loginURL = $loginURL; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'pluginManifests')] + public function getPluginManifests(): ?string + { + return $this->pluginManifests; + } + + /** + * JSON string containing plugin manifests to load for the meeting. + */ + public function setPluginManifests(string $pluginManifests): self + { + // Ensure the value is valid JSON by decoding and re-encoding + json_decode($pluginManifests); + + if (JSON_ERROR_NONE !== json_last_error()) { + throw new \InvalidArgumentException('pluginManifests must be a valid JSON string.'); + } + + $this->pluginManifests = $pluginManifests; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'pluginManifestsFetchUrl')] + public function getPluginManifestsFetchUrl(): ?string + { + return $this->pluginManifestsFetchUrl; + } + + /** + * URL to fetch the plugin manifests from. + */ + public function setPluginManifestsFetchUrl(string $pluginManifestsFetchUrl): self + { + $this->pluginManifestsFetchUrl = $pluginManifestsFetchUrl; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'presentationConversionCacheEnabled')] + public function isPresentationConversionCacheEnabled(): ?bool + { + return $this->presentationConversionCacheEnabled; + } + + /** + * Enable or disable caching for presentation conversion. + */ + public function setPresentationConversionCacheEnabled(bool $presentationConversionCacheEnabled): self + { + $this->presentationConversionCacheEnabled = $presentationConversionCacheEnabled; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'maxNumPages')] + public function getMaxNumPages(): ?int + { + return $this->maxNumPages; + } + + /** + * Maximum number of pages allowed for presentations in the meeting. + */ + public function setMaxNumPages(int $maxNumPages): self + { + $this->maxNumPages = $maxNumPages; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'multiUserWhiteboardEnabled')] + public function isMultiUserWhiteboardEnabled(): ?bool + { + return $this->multiUserWhiteboardEnabled; + } + + /** + * Enable or disable the multi-user whiteboard feature. + */ + public function setMultiUserWhiteboardEnabled(bool $multiUserWhiteboardEnabled): self + { + $this->multiUserWhiteboardEnabled = $multiUserWhiteboardEnabled; + + return $this; + } + public function getHTTPQuery(): string { - $queries = [ - 'name' => $this->meetingName, - 'meetingID' => $this->meetingId, - 'attendeePW' => $this->attendeePassword, - 'moderatorPW' => $this->moderatorPassword, - 'dialNumber' => $this->dialNumber, - 'voiceBridge' => $this->voiceBridge, - 'webVoice' => $this->webVoice, - 'logoutURL' => $this->logoutUrl, - 'record' => !is_null($this->record) ? ($this->record ? 'true' : 'false') : $this->record, - 'duration' => $this->duration, - 'maxParticipants' => $this->maxParticipants, - 'autoStartRecording' => !is_null($this->autoStartRecording) ? ($this->autoStartRecording ? 'true' : 'false') : $this->autoStartRecording, - 'allowStartStopRecording' => !is_null($this->allowStartStopRecording) ? ($this->allowStartStopRecording ? 'true' : 'false') : $this->allowStartStopRecording, - 'welcome' => !is_null($this->welcomeMessage) ? trim($this->welcomeMessage) : '', - 'moderatorOnlyMessage' => !is_null($this->moderatorOnlyMessage) ? trim($this->moderatorOnlyMessage) : '', - 'webcamsOnlyForModerator' => !is_null($this->webcamsOnlyForModerator) ? ($this->webcamsOnlyForModerator ? 'true' : 'false') : $this->webcamsOnlyForModerator, - 'logo' => $this->logo, - 'copyright' => $this->copyright, - 'muteOnStart' => !is_null($this->muteOnStart) ? ($this->muteOnStart ? 'true' : 'false') : $this->muteOnStart, - 'guestPolicy' => $this->guestPolicy, - 'lockSettingsDisableCam' => !is_null($this->lockSettingsDisableCam) ? ($this->lockSettingsDisableCam ? 'true' : 'false') : $this->lockSettingsDisableCam, - 'lockSettingsDisableMic' => !is_null($this->lockSettingsDisableMic) ? ($this->lockSettingsDisableMic ? 'true' : 'false') : $this->lockSettingsDisableMic, - 'lockSettingsDisablePrivateChat' => !is_null($this->lockSettingsDisablePrivateChat) ? ($this->lockSettingsDisablePrivateChat ? 'true' : 'false') : $this->lockSettingsDisablePrivateChat, - 'lockSettingsDisablePublicChat' => !is_null($this->lockSettingsDisablePublicChat) ? ($this->lockSettingsDisablePublicChat ? 'true' : 'false') : $this->lockSettingsDisablePublicChat, - 'lockSettingsDisableNote' => !is_null($this->lockSettingsDisableNote) ? ($this->lockSettingsDisableNote ? 'true' : 'false') : $this->lockSettingsDisableNote, - 'lockSettingsHideUserList' => !is_null($this->lockSettingsHideUserList) ? ($this->lockSettingsHideUserList ? 'true' : 'false') : $this->lockSettingsHideUserList, - 'lockSettingsLockedLayout' => !is_null($this->lockSettingsLockedLayout) ? ($this->lockSettingsLockedLayout ? 'true' : 'false') : $this->lockSettingsLockedLayout, - 'lockSettingsLockOnJoin' => !is_null($this->lockSettingsLockOnJoin) ? ($this->lockSettingsLockOnJoin ? 'true' : 'false') : $this->lockSettingsLockOnJoin, - 'lockSettingsLockOnJoinConfigurable' => !is_null($this->lockSettingsLockOnJoinConfigurable) ? ($this->lockSettingsLockOnJoinConfigurable ? 'true' : 'false') : $this->lockSettingsLockOnJoinConfigurable, - 'lockSettingsHideViewersCursor' => !is_null($this->lockSettingsHideViewersCursor) ? ($this->lockSettingsHideViewersCursor ? 'true' : 'false') : $this->lockSettingsHideViewersCursor, - 'allowModsToUnmuteUsers' => !is_null($this->allowModsToUnmuteUsers) ? ($this->allowModsToUnmuteUsers ? 'true' : 'false') : $this->allowModsToUnmuteUsers, - 'allowModsToEjectCameras' => !is_null($this->allowModsToEjectCameras) ? ($this->allowModsToEjectCameras ? 'true' : 'false') : $this->allowModsToEjectCameras, - 'bannerText' => !is_null($this->bannerText) ? trim($this->bannerText) : '', - 'bannerColor' => !is_null($this->bannerColor) ? trim($this->bannerColor) : '', - 'learningDashboardEnabled' => !is_null($this->learningDashboardEnabled) ? ($this->learningDashboardEnabled ? 'true' : 'false') : $this->learningDashboardEnabled, - 'virtualBackgroundsDisabled' => !is_null($this->virtualBackgroundsDisabled) ? ($this->virtualBackgroundsDisabled ? 'true' : 'false') : $this->virtualBackgroundsDisabled, - 'endWhenNoModeratorDelayInMinutes' => $this->endWhenNoModeratorDelayInMinutes, - 'allowRequestsWithoutSession' => !is_null($this->allowRequestsWithoutSession) ? ($this->allowRequestsWithoutSession ? 'true' : 'false') : $this->allowRequestsWithoutSession, - 'meetingEndedURL' => $this->meetingEndedURL, - 'breakoutRoomsEnabled' => !is_null($this->breakoutRoomsEnabled) ? ($this->breakoutRoomsEnabled ? 'true' : 'false') : $this->breakoutRoomsEnabled, - 'breakoutRoomsRecord' => !is_null($this->breakoutRoomsRecord) ? ($this->breakoutRoomsRecord ? 'true' : 'false') : $this->breakoutRoomsRecord, - 'breakoutRoomsPrivateChatEnabled' => !is_null($this->breakoutRoomsPrivateChatEnabled) ? ($this->breakoutRoomsPrivateChatEnabled ? 'true' : 'false') : $this->breakoutRoomsPrivateChatEnabled, - 'endWhenNoModerator' => !is_null($this->endWhenNoModerator) ? ($this->endWhenNoModerator ? 'true' : 'false') : $this->endWhenNoModerator, - 'meetingKeepEvents' => !is_null($this->meetingKeepEvents) ? ($this->meetingKeepEvents ? 'true' : 'false') : $this->meetingKeepEvents, - 'meetingLayout' => $this->meetingLayout, - 'meetingCameraCap' => $this->meetingCameraCap, - 'userCameraCap' => $this->userCameraCap, - 'meetingExpireIfNoUserJoinedInMinutes' => $this->meetingExpireIfNoUserJoinedInMinutes, - 'meetingExpireWhenLastUserLeftInMinutes' => $this->meetingExpireWhenLastUserLeftInMinutes, - 'preUploadedPresentationOverrideDefault' => $this->preUploadedPresentationOverrideDefault, - 'disabledFeatures' => join(',', $this->disabledFeatures), - 'disabledFeaturesExclude' => join(',', $this->disabledFeaturesExclude), - 'notifyRecordingIsOn' => !is_null($this->notifyRecordingIsOn) ? ($this->notifyRecordingIsOn ? 'true' : 'false') : $this->notifyRecordingIsOn, - 'presentationUploadExternalUrl' => $this->presentationUploadExternalUrl, - 'presentationUploadExternalDescription' => $this->presentationUploadExternalDescription, - 'recordFullDurationMedia' => !is_null($this->recordFullDurationMedia) ? ($this->recordFullDurationMedia ? 'true' : 'false') : $this->recordFullDurationMedia, - ]; + $queries = $this->toApiDataArray(); // Add breakout rooms parameters only if the meeting is a breakout room if ($this->isBreakout()) { @@ -1479,7 +1786,7 @@ public function getHTTPQuery(): string } } - $this->buildMeta($queries); + $queries = $this->buildMeta($queries); return $this->buildHTTPQuery($queries); } diff --git a/src/Parameters/DeleteRecordingsParameters.php b/src/Parameters/DeleteRecordingsParameters.php index 028d13d0..200b4db7 100644 --- a/src/Parameters/DeleteRecordingsParameters.php +++ b/src/Parameters/DeleteRecordingsParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,32 +20,30 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class DeleteRecordingsParameters. */ class DeleteRecordingsParameters extends BaseParameters { - private ?string $recordingId = null; + private string $recordingId; - public function __construct(string $recordingId = null) + public function __construct(string $recordingId) { $this->recordingId = $recordingId; } + #[ApiParameterMapper(attributeName: 'recordID')] public function getRecordingId(): ?string { return $this->recordingId; } - public function setRecordingId(string $recordingId): DeleteRecordingsParameters + public function setRecordingId(string $recordingId): self { $this->recordingId = $recordingId; return $this; } - - public function getHTTPQuery(): string - { - return $this->buildHTTPQuery(['recordID' => $this->recordingId]); - } } diff --git a/src/Parameters/DocumentableTrait.php b/src/Parameters/DocumentableTrait.php index 501e9e6b..553fd70b 100644 --- a/src/Parameters/DocumentableTrait.php +++ b/src/Parameters/DocumentableTrait.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,63 +20,99 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\Parameters\Config\DocumentOptionsStore; +use BigBlueButton\Core\Document; +use BigBlueButton\Core\DocumentFile; +use BigBlueButton\Core\DocumentUrl; +use BigBlueButton\Enum\DocumentOption; +use BigBlueButton\Parameters\Config\DocumentOptions; trait DocumentableTrait { /** - * @var array + * @var Document[] */ - protected array $presentations = []; + protected array $documents = []; - /** - * @return array - */ - public function getPresentations(): array + public function addDocument(Document $document): self { - return $this->presentations; + $this->documents[] = $document; + + return $this; } - public function addPresentation(string $nameOrUrl, $content = null, ?string $filename = null, DocumentOptionsStore $attributes = null): self + /** + * @return Document[] + */ + public function getDocuments(): array { - $this->presentations[$nameOrUrl] = [ - 'content' => !$content ?: base64_encode($content), - 'filename' => $filename, - 'attributes' => $attributes - ]; - - return $this; + return $this->documents; } - public function getPresentationsAsXML(): string + /** + * @throws \Exception + */ + public function getDocumentsAsXML(): string { $result = ''; - if (!empty($this->presentations)) { - $xml = new \SimpleXMLElement(''); - $module = $xml->addChild('module'); - $module->addAttribute('name', 'presentation'); - - foreach ($this->presentations as $nameOrUrl => $data) { - $presentation = $module->addChild('document'); - if (0 === mb_strpos($nameOrUrl, 'http')) { - $presentation->addAttribute('url', $nameOrUrl); - } else { - $presentation->addAttribute('name', $nameOrUrl); + + if (!empty($this->documents)) { + $xml = new \SimpleXMLElement(''); + $moduleNode = $xml->addChild('module'); + $moduleNode->addAttribute('name', 'presentation'); + + foreach ($this->documents as $document) { + $documentNode = $moduleNode->addChild('document'); + + if (null === $documentNode) { + throw new \Exception('XML could not be generated'); } - if (!empty($data['filename'])) { - $presentation->addAttribute('filename', $data['filename']); + if ($document->getValidation()) { + if (!$document->isValid()) { + throw new \Exception("Document `{$document->getName()}` is not valid."); + } } - if (!empty($data['content'])) { - $presentation[0] = $data['content']; + switch (true) { + case $document instanceof DocumentUrl: + $documentNode->addAttribute('url', $document->getUrl()); + + if ($document->getName()) { + $documentNode->addAttribute('filename', $document->getName()); + } + + break; + case $document instanceof DocumentFile: + if ($document->getName()) { + $documentNode->addAttribute('name', $document->getName()); + } + $documentNode[0] = base64_encode($document->getFileContent()); // @phpstan-ignore-line + + break; + default: + throw new \Exception('The class `' . get_class($document) . '` is not a valid document. It shall be either an instance (direct or extended) of DocumentUrl or a DocumentFile.'); + } + + if (null !== $document->isCurrent()) { + $value = $document->isCurrent() ? 'true' : 'false'; + $documentNode->addAttribute(DocumentOption::CURRENT->value, $value); + } + + if (null !== $document->isDownloadable()) { + $value = $document->isDownloadable() ? 'true' : 'false'; + $documentNode->addAttribute(DocumentOption::DOWNLOADABLE->value, $value); } - // Add attributes using DocumentAttributes class - foreach ($data['attributes']->getAttributes() as $attrName => $attrValue) { - $presentation->addAttribute($attrName, $attrValue); + if (null !== $document->isRemovable()) { + $value = $document->isRemovable() ? 'true' : 'false'; + $documentNode->addAttribute(DocumentOption::REMOVABLE->value, $value); + } + + foreach ($document->getProperties() as $propertyKey => $propertyValue) { + $documentNode->addAttribute($propertyKey, $propertyValue); } } + $result = $xml->asXML(); } @@ -86,4 +122,78 @@ public function getPresentationsAsXML(): string return $result; } + + /** + * @param array $otherAttributes + * + * @throws \Exception + * + * @deprecated This function has been replaced by `addDocument` + */ + public function addPresentation(string $nameOrUrl, ?string $content = null, ?string $filename = null, ?DocumentOptions $documentOptions = null, array $otherAttributes = []): self + { + if (0 === mb_strpos($nameOrUrl, 'http')) { + $document = new DocumentUrl($nameOrUrl, $filename); + } else { + $filename = $filename ?: $nameOrUrl; + + if (!$content) { + throw new \Exception('In case the first parameter is no URL, a content-value (2nd argument) is required.'); + } + + $document = new DocumentFile($nameOrUrl, $filename); + $document->setFileContent($content); + } + + // Set the options + if (null !== $documentOptions) { + foreach ($documentOptions->getOptions() as $documentOption => $value) { + switch ($documentOption) { + case DocumentOption::CURRENT->value: + $document->setCurrent($value); + + break; + case DocumentOption::DOWNLOADABLE->value: + $document->setDownloadable($value); + + break; + case DocumentOption::REMOVABLE->value: + $document->setRemovable($value); + + break; + default: + throw new \Exception('The value ' . $documentOption . ' is not valid.'); + } + } + } + + // Set other attributes + foreach ($otherAttributes as $attribute => $value) { + $document->addProperty($attribute, $value); + } + + $this->addDocument($document); + + return $this; + } + + /** + * @return Document[] + * + * @deprecated This function has been replaced by `getDocuments` + */ + public function getPresentations(): array + { + return $this->getDocuments(); + } + + /** + * @throws \Exception + * + * @deprecated This function has been replaced by `getDocumentsAsXML` + */ + public function getPresentationsAsXML(): string + { + return $this->getDocumentsAsXML(); + } } diff --git a/src/Parameters/EndMeetingParameters.php b/src/Parameters/EndMeetingParameters.php index ea948a6c..ec2058c6 100644 --- a/src/Parameters/EndMeetingParameters.php +++ b/src/Parameters/EndMeetingParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,24 +20,29 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class EndMeetingParameters. */ class EndMeetingParameters extends BaseParameters { - private ?string $meetingId = null; + private string $meetingId; /** + * The password of the moderator. + * * @deprecated */ - private ?string $password = null; + private ?string $password; - public function __construct(string $meetingId = null, string $password = null) + public function __construct(string $meetingId, ?string $password = null) { $this->password = $password; $this->meetingId = $meetingId; } + #[ApiParameterMapper(attributeName: 'meetingID')] public function getMeetingId(): ?string { return $this->meetingId; @@ -53,6 +58,7 @@ public function setMeetingId(string $meetingId): self /** * @deprecated */ + #[ApiParameterMapper(attributeName: 'password')] public function getPassword(): ?string { return $this->password; @@ -61,20 +67,10 @@ public function getPassword(): ?string /** * @deprecated */ - public function setPassword(string $password): self + public function setPassword(?string $password): self { $this->password = $password; return $this; } - - public function getHTTPQuery(): string - { - return $this->buildHTTPQuery( - [ - 'meetingID' => $this->meetingId, - 'password' => $this->password, - ] - ); - } } diff --git a/src/Parameters/FeedbackParameters.php b/src/Parameters/FeedbackParameters.php new file mode 100644 index 00000000..42f1dac1 --- /dev/null +++ b/src/Parameters/FeedbackParameters.php @@ -0,0 +1,151 @@ +. + */ + +namespace BigBlueButton\Parameters; + +use BigBlueButton\Attribute\ApiParameterMapper; + +/** + * Class FeedbackParameters. + * + * Parameters for the feedback API call. + * This endpoint replaces the old /html5client/feedback endpoint with /api/feedback. + * It allows submitting feedback about a meeting or session. + */ +class FeedbackParameters extends BaseParameters +{ + private string $sessionToken; + + private ?int $rating = null; + + private ?string $comment = null; + + private ?string $meetingID = null; + + private ?string $userID = null; + + /** + * FeedbackParameters constructor. + * + * @param string $sessionToken Session token identifying the user session + */ + public function __construct(string $sessionToken) + { + $this->sessionToken = $sessionToken; + } + + #[ApiParameterMapper(attributeName: 'sessionToken')] + public function getSessionToken(): string + { + return $this->sessionToken; + } + + /** + * Set the session token. + * + * @param string $sessionToken Session token identifying the user session + */ + public function setSessionToken(string $sessionToken): self + { + $this->sessionToken = $sessionToken; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'rating')] + public function getRating(): ?int + { + return $this->rating; + } + + /** + * Set the rating for the feedback. + * Typically a numeric rating (e.g., 1-5 stars). + * + * @param null|int $rating The rating value + */ + public function setRating(?int $rating): self + { + $this->rating = $rating; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'comment')] + public function getComment(): ?string + { + return $this->comment; + } + + /** + * Set the comment for the feedback. + * + * @param null|string $comment The feedback comment + */ + public function setComment(?string $comment): self + { + $this->comment = $comment; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'meetingID')] + public function getMeetingID(): ?string + { + return $this->meetingID; + } + + /** + * Set the meeting ID for the feedback. + * + * @param null|string $meetingID The meeting ID + */ + public function setMeetingID(?string $meetingID): self + { + $this->meetingID = $meetingID; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'userID')] + public function getUserID(): ?string + { + return $this->userID; + } + + /** + * Set the user ID for the feedback. + * + * @param null|string $userID The user ID + */ + public function setUserID(?string $userID): self + { + $this->userID = $userID; + + return $this; + } + + public function getHTTPQuery(): string + { + $queries = $this->toApiDataArray(); + + return $this->buildHTTPQuery($queries); + } +} diff --git a/src/Parameters/GetJoinUrlParameters.php b/src/Parameters/GetJoinUrlParameters.php new file mode 100644 index 00000000..d4d1be79 --- /dev/null +++ b/src/Parameters/GetJoinUrlParameters.php @@ -0,0 +1,168 @@ +. + */ + +namespace BigBlueButton\Parameters; + +use BigBlueButton\Attribute\ApiParameterMapper; +use BigBlueButton\Enum\MeetingLayout; + +/** + * Class GetJoinUrlParameters. + * + * Parameters for the getJoinUrl API call. + * This endpoint generates a new /join URL that can be used to create a new session + * for an existing user with the same user ID. + */ +class GetJoinUrlParameters extends MetaParameters +{ + /** @var array */ + private array $userData = []; + + private string $sessionToken; + + private ?bool $replaceSession = null; + + private ?string $sessionName = null; + + private ?MeetingLayout $enforceLayout = null; + + /** + * GetJoinUrlParameters constructor. + * + * @param string $sessionToken Session token to identify the user who is requesting a new join url + */ + public function __construct(string $sessionToken) + { + $this->sessionToken = $sessionToken; + } + + #[ApiParameterMapper(attributeName: 'sessionToken')] + public function getSessionToken(): string + { + return $this->sessionToken; + } + + /** + * Set the session token. + * + * @param string $sessionToken Session token to identify the user + */ + public function setSessionToken(string $sessionToken): self + { + $this->sessionToken = $sessionToken; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'replaceSession')] + public function isReplaceSession(): ?bool + { + return $this->replaceSession; + } + + /** + * When set to true, using the newly generated join URL will immediately invalidate the original session. + * + * @param bool $replaceSession Whether to replace the original session + */ + public function setReplaceSession(bool $replaceSession): self + { + $this->replaceSession = $replaceSession; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'sessionName')] + public function getSessionName(): ?string + { + return $this->sessionName; + } + + /** + * Assign a descriptive name to the newly created session. + * Allowing to quickly understand the session's origin or purpose when reviewing the user's session history. + * + * @param null|string $sessionName The session name + */ + public function setSessionName(?string $sessionName): self + { + $this->sessionName = $sessionName; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'enforceLayout')] + public function getEnforceLayout(): ?MeetingLayout + { + return $this->enforceLayout; + } + + /** + * Specify a layout enforcement setting for the new session. + * If provided, this overrides the enforceLayout parameter inherited from the original user's session. + * If not specified, the new session inherits the layout behavior of the original session. + * + * @param null|MeetingLayout $enforceLayout The layout to enforce + */ + public function setEnforceLayout(?MeetingLayout $enforceLayout): self + { + $this->enforceLayout = $enforceLayout; + + return $this; + } + + public function getHTTPQuery(): string + { + $queries = $this->toApiDataArray(); + + // Add meta parameters + $queries = $this->buildMeta($queries); + + // Add userdata parameters (don't use meta prefix for userdata) + $this->buildUserData($queries); + + return $this->buildHTTPQuery($queries); + } + + public function getUserData(string $key): mixed + { + return $this->userData[$key]; + } + + public function addUserData(string $key, mixed $value): static + { + $this->userData[$key] = $value; + + return $this; + } + + protected function buildUserData(mixed &$queries): void + { + foreach ($this->userData as $key => $value) { + $queryKey = 'userdata-' . $key; + + if (is_bool($value)) { + $queries[$queryKey] = $value ? 'true' : 'false'; + } else { + $queries[$queryKey] = (string) $value; + } + } + } +} diff --git a/src/Parameters/GetMeetingInfoParameters.php b/src/Parameters/GetMeetingInfoParameters.php index 0d1a0ca0..5238986d 100644 --- a/src/Parameters/GetMeetingInfoParameters.php +++ b/src/Parameters/GetMeetingInfoParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,22 +20,25 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class GetMeetingInfoParameters. */ class GetMeetingInfoParameters extends BaseParameters { - private ?string $meetingId = null; + private string $meetingId; private ?int $offset = null; private ?int $limit = null; - public function __construct(?string $meetingId = null) + public function __construct(string $meetingId) { $this->meetingId = $meetingId; } + #[ApiParameterMapper(attributeName: 'meetingID')] public function getMeetingId(): ?string { return $this->meetingId; @@ -48,38 +51,29 @@ public function setMeetingId(string $meetingId): self return $this; } + #[ApiParameterMapper(attributeName: 'offset')] public function getOffset(): ?int { return $this->offset; } - public function setOffset(int $offset): self + public function setOffset(?int $offset): self { $this->offset = $offset; return $this; } + #[ApiParameterMapper(attributeName: 'limit')] public function getLimit(): ?int { return $this->limit; } - public function setLimit(int $limit): self + public function setLimit(?int $limit): self { $this->limit = $limit; return $this; } - - public function getHTTPQuery(): string - { - return $this->buildHTTPQuery( - [ - 'meetingID' => $this->meetingId, - 'offset' => $this->offset, - 'limit' => $this->limit, - ] - ); - } } diff --git a/src/Parameters/GetRecordingTextTracksParameters.php b/src/Parameters/GetRecordingTextTracksParameters.php index fd5bea78..3b598f41 100644 --- a/src/Parameters/GetRecordingTextTracksParameters.php +++ b/src/Parameters/GetRecordingTextTracksParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,21 +20,24 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class GetRecordingTextTracksParameters. */ class GetRecordingTextTracksParameters extends MetaParameters { - private ?string $recordId = null; + private string $recordId; /** * GetRecordingTextTracksParameters constructor. */ - public function __construct(string $recordId = null) + public function __construct(string $recordId) { $this->recordId = $recordId; } + #[ApiParameterMapper(attributeName: 'recordID')] public function getRecordId(): ?string { return $this->recordId; @@ -49,11 +52,8 @@ public function setRecordId(string $recordId): self public function getHTTPQuery(): string { - $queries = [ - 'recordID' => $this->recordId, - ]; - - $this->buildMeta($queries); + $queries = $this->toApiDataArray(); + $queries = $this->buildMeta($queries); return $this->buildHTTPQuery($queries); } diff --git a/src/Parameters/GetRecordingsParameters.php b/src/Parameters/GetRecordingsParameters.php index fcefbf66..5deb3994 100644 --- a/src/Parameters/GetRecordingsParameters.php +++ b/src/Parameters/GetRecordingsParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,6 +20,8 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class GetRecordingsParameters. */ @@ -31,6 +33,11 @@ class GetRecordingsParameters extends MetaParameters private ?string $state = null; + private ?int $offset = null; + + private ?int $limit = null; + + #[ApiParameterMapper(attributeName: 'meetingID')] public function getMeetingId(): ?string { return $this->meetingId; @@ -43,6 +50,7 @@ public function setMeetingId(string $meetingId): self return $this; } + #[ApiParameterMapper(attributeName: 'recordID')] public function getRecordId(): ?string { return $this->recordId; @@ -55,6 +63,7 @@ public function setRecordId(string $recordId): self return $this; } + #[ApiParameterMapper(attributeName: 'state')] public function getState(): ?string { return $this->state; @@ -67,15 +76,36 @@ public function setState(string $state): self return $this; } - public function getHTTPQuery(): string + #[ApiParameterMapper(attributeName: 'offset')] + public function getOffset(): ?int + { + return $this->offset; + } + + public function setOffset(?int $offset): self + { + $this->offset = $offset; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'limit')] + public function getLimit(): ?int + { + return $this->limit; + } + + public function setLimit(?int $limit): self { - $queries = [ - 'meetingID' => $this->meetingId, - 'recordID' => $this->recordId, - 'state' => $this->state, - ]; + $this->limit = $limit; - $this->buildMeta($queries); + return $this; + } + + public function getHTTPQuery(): string + { + $queries = $this->toApiDataArray(); + $queries = $this->buildMeta($queries); return $this->buildHTTPQuery($queries); } diff --git a/src/Parameters/HooksCreateParameters.php b/src/Parameters/HooksCreateParameters.php index 24377be4..ec0b0176 100644 --- a/src/Parameters/HooksCreateParameters.php +++ b/src/Parameters/HooksCreateParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,13 +20,19 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; +use BigBlueButton\Enum\WebHookEvent; + class HooksCreateParameters extends BaseParameters { private string $callbackUrl; private ?string $meetingId = null; - private ?string $eventId = null; + /** + * @var WebHookEvent[] + */ + private array $eventId = []; private ?bool $getRaw = null; @@ -35,6 +41,7 @@ public function __construct(string $callbackUrl) $this->callbackUrl = $callbackUrl; } + #[ApiParameterMapper(attributeName: 'callbackURL')] public function getCallbackUrl(): string { return $this->callbackUrl; @@ -47,6 +54,7 @@ public function setCallbackUrl(string $callbackUrl): self return $this; } + #[ApiParameterMapper(attributeName: 'meetingID')] public function getMeetingId(): ?string { return $this->meetingId; @@ -59,18 +67,28 @@ public function setMeetingId(string $meetingId): self return $this; } - public function getEventId(): ?string + /** + * @return WebHookEvent[] + */ + #[ApiParameterMapper(attributeName: 'eventID')] + public function getEventId(): array { return $this->eventId; } - public function setEventId(string $eventId): self + /** + * @param WebHookEvent[] $eventId + * + * @since 2.5 + */ + public function setEventId(array $eventId): self { $this->eventId = $eventId; return $this; } + #[ApiParameterMapper(attributeName: 'getRaw')] public function getRaw(): ?bool { return $this->getRaw; @@ -82,15 +100,4 @@ public function setGetRaw(bool $getRaw): self return $this; } - - public function getHTTPQuery(): string - { - $queries = [ - 'callbackURL' => $this->callbackUrl, - 'meetingID' => $this->meetingId, - 'getRaw' => !is_null($this->getRaw) ? ($this->getRaw ? 'true' : 'false') : $this->getRaw, - ]; - - return $this->buildHTTPQuery($queries); - } } diff --git a/src/Parameters/HooksDestroyParameters.php b/src/Parameters/HooksDestroyParameters.php index 629c85c4..a2a6af83 100644 --- a/src/Parameters/HooksDestroyParameters.php +++ b/src/Parameters/HooksDestroyParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,6 +20,8 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + class HooksDestroyParameters extends BaseParameters { private string $hookId; @@ -29,6 +31,7 @@ public function __construct(string $hookId) $this->hookId = $hookId; } + #[ApiParameterMapper(attributeName: 'hookID')] public function getHookId(): string { return $this->hookId; @@ -40,13 +43,4 @@ public function setHookId(string $hookId): self return $this; } - - public function getHTTPQuery(): string - { - $queries = [ - 'hookID' => $this->hookId, - ]; - - return $this->buildHTTPQuery($queries); - } } diff --git a/src/Parameters/InsertDocumentParameters.php b/src/Parameters/InsertDocumentParameters.php index 722d7a3f..bf88d310 100644 --- a/src/Parameters/InsertDocumentParameters.php +++ b/src/Parameters/InsertDocumentParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,6 +20,8 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class EndMeetingParameters. */ @@ -27,13 +29,14 @@ class InsertDocumentParameters extends BaseParameters { use DocumentableTrait; - private ?string $meetingId = null; + private string $meetingId; - public function __construct(string $meetingId = null) + public function __construct(string $meetingId) { $this->meetingId = $meetingId; } + #[ApiParameterMapper(attributeName: 'meetingID')] public function getMeetingId(): ?string { return $this->meetingId; @@ -45,13 +48,4 @@ public function setMeetingId(string $meetingId): self return $this; } - - public function getHTTPQuery(): string - { - return $this->buildHTTPQuery( - [ - 'meetingID' => $this->meetingId, - ] - ); - } } diff --git a/src/Parameters/IsMeetingRunningParameters.php b/src/Parameters/IsMeetingRunningParameters.php index e06c8655..f05185a0 100644 --- a/src/Parameters/IsMeetingRunningParameters.php +++ b/src/Parameters/IsMeetingRunningParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,18 +20,21 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class IsMeetingRunningParameters. */ class IsMeetingRunningParameters extends BaseParameters { - private ?string $meetingId = null; + private string $meetingId; - public function __construct(string $meetingId = null) + public function __construct(string $meetingId) { $this->meetingId = $meetingId; } + #[ApiParameterMapper(attributeName: 'meetingID')] public function getMeetingId(): ?string { return $this->meetingId; @@ -43,9 +46,4 @@ public function setMeetingId(string $meetingId): self return $this; } - - public function getHTTPQuery(): string - { - return $this->buildHTTPQuery(['meetingID' => $this->meetingId]); - } } diff --git a/src/Parameters/JoinMeetingParameters.php b/src/Parameters/JoinMeetingParameters.php index 9f79b8a5..7032362b 100644 --- a/src/Parameters/JoinMeetingParameters.php +++ b/src/Parameters/JoinMeetingParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,6 +20,8 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; +use BigBlueButton\Enum\MeetingLayout; use BigBlueButton\Enum\Role; /** @@ -27,9 +29,9 @@ */ class JoinMeetingParameters extends UserDataParameters { - private ?string $meetingId; + private string $meetingId; - private ?string $username; + private string $username; /** * @deprecated Password-string replaced by an Enum\Role-constant in JoinMeetingParameters::__construct() @@ -49,22 +51,29 @@ class JoinMeetingParameters extends UserDataParameters /** * @var array */ - private array $customParameters; + private array $customParameters = []; - private ?string $role = null; + private ?Role $role = null; private ?bool $excludeFromDashboard = null; private ?bool $guest = null; - private ?string $defaultLayout = null; - /** - * @param mixed $passwordOrRole - * @param mixed $meetingId - * @param mixed $username + * @deprecated since 3.0.0 */ - public function __construct($meetingId = null, $username = null, $passwordOrRole = null) + private ?MeetingLayout $defaultLayout = null; + + private ?string $errorRedirectUrl = null; + private ?string $webcamBackgroundURL = null; + + private ?bool $bot = null; + private ?string $enforceLayout = null; + private ?string $logoutURL = null; + private ?string $firstName = null; + private ?string $lastName = null; + + public function __construct(string $meetingId, string $username, Role|string $passwordOrRole) { $this->meetingId = $meetingId; $this->username = $username; @@ -74,21 +83,22 @@ public function __construct($meetingId = null, $username = null, $passwordOrRole } else { $this->password = $passwordOrRole; } - $this->customParameters = []; } + #[ApiParameterMapper(attributeName: 'meetingID')] public function getMeetingId(): ?string { return $this->meetingId; } - public function setMeetingId(string $meetingId): JoinMeetingParameters + public function setMeetingId(string $meetingId): self { $this->meetingId = $meetingId; return $this; } + #[ApiParameterMapper(attributeName: 'fullName')] public function getUsername(): ?string { return $this->username; @@ -104,6 +114,7 @@ public function setUsername(string $username): self /** * @deprecated Password-string replaced by an Enum\Role-constant in JoinMeetingParameters::__construct() */ + #[ApiParameterMapper(attributeName: 'password')] public function getPassword(): ?string { return $this->password; @@ -112,13 +123,14 @@ public function getPassword(): ?string /** *@deprecated Password-string replaced by an Enum\Role-constant in JoinMeetingParameters::__construct() */ - public function setPassword(string $password): self + public function setPassword(?string $password): self { $this->password = $password; return $this; } + #[ApiParameterMapper(attributeName: 'userID')] public function getUserId(): ?string { return $this->userId; @@ -131,6 +143,7 @@ public function setUserId(string $userId): self return $this; } + #[ApiParameterMapper(attributeName: 'webVoiceConf')] public function getWebVoiceConf(): ?string { return $this->webVoiceConf; @@ -143,6 +156,7 @@ public function setWebVoiceConf(string $webVoiceConf): self return $this; } + #[ApiParameterMapper(attributeName: 'createTime')] public function getCreationTime(): ?float { return $this->creationTime; @@ -155,6 +169,7 @@ public function setCreationTime(float $creationTime): self return $this; } + #[ApiParameterMapper(attributeName: 'avatarURL')] public function getAvatarURL(): ?string { return $this->avatarURL; @@ -167,6 +182,7 @@ public function setAvatarURL(string $avatarURL): self return $this; } + #[ApiParameterMapper(attributeName: 'redirect')] public function isRedirect(): ?bool { return $this->redirect; @@ -179,18 +195,20 @@ public function setRedirect(bool $redirect): self return $this; } - public function getRole(): ?string + #[ApiParameterMapper(attributeName: 'role')] + public function getRole(): ?Role { return $this->role; } - public function setRole(string $role): self + public function setRole(Role $role): self { $this->role = $role; return $this; } + #[ApiParameterMapper(attributeName: 'excludeFromDashboard')] public function isExcludeFromDashboard(): ?bool { return $this->excludeFromDashboard; @@ -203,6 +221,7 @@ public function setExcludeFromDashboard(bool $excludeFromDashboard): self return $this; } + #[ApiParameterMapper(attributeName: 'guest')] public function isGuest(): ?bool { return $this->guest; @@ -215,18 +234,116 @@ public function setGuest(bool $guest): self return $this; } - public function getDefaultLayout(): ?string + /** + * @deprecated since 3.0.0 + */ + #[ApiParameterMapper(attributeName: 'defaultLayout')] + public function getDefaultLayout(): ?MeetingLayout { return $this->defaultLayout; } - public function setDefaultLayout(string $defaultLayout): self + /** + * @deprecated since 3.0.0, use "userdata-bbb_default_layout" instead + */ + public function setDefaultLayout(MeetingLayout $defaultLayout): self { $this->defaultLayout = $defaultLayout; return $this; } + #[ApiParameterMapper(attributeName: 'errorRedirectUrl')] + public function getErrorRedirectUrl(): ?string + { + return $this->errorRedirectUrl; + } + + public function setErrorRedirectUrl(string $errorRedirectUrl): self + { + $this->errorRedirectUrl = $errorRedirectUrl; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'webcamBackgroundURL')] + public function getWebcamBackgroundURL(): ?string + { + return $this->webcamBackgroundURL; + } + + public function setWebcamBackgroundURL(string $webcamBackgroundURL): self + { + $this->webcamBackgroundURL = $webcamBackgroundURL; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'bot')] + public function isBot(): ?bool + { + return $this->bot; + } + + public function setBot(bool $bot): self + { + $this->bot = $bot; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'enforceLayout')] + public function getEnforceLayout(): ?string + { + return $this->enforceLayout; + } + + public function setEnforceLayout(string $enforceLayout): self + { + $this->enforceLayout = $enforceLayout; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'logoutURL')] + public function getLogoutURL(): ?string + { + return $this->logoutURL; + } + + public function setLogoutURL(string $logoutURL): self + { + $this->logoutURL = $logoutURL; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'firstName')] + public function getFirstName(): ?string + { + return $this->firstName; + } + + public function setFirstName(string $firstName): self + { + $this->firstName = $firstName; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'lastName')] + public function getLastName(): ?string + { + return $this->lastName; + } + + public function setLastName(string $lastName): self + { + $this->lastName = $lastName; + + return $this; + } + public function setCustomParameter(string $paramName, string $paramValue): self { $this->customParameters[$paramName] = $paramValue; @@ -236,20 +353,7 @@ public function setCustomParameter(string $paramName, string $paramValue): self public function getHTTPQuery(): string { - $queries = [ - 'meetingID' => $this->meetingId, - 'fullName' => $this->username, - 'password' => $this->password, - 'userID' => $this->userId, - 'webVoiceConf' => $this->webVoiceConf, - 'createTime' => $this->creationTime, - 'role' => $this->role, - 'excludeFromDashboard' => !is_null($this->excludeFromDashboard) ? ($this->excludeFromDashboard ? 'true' : 'false') : $this->excludeFromDashboard, - 'avatarURL' => $this->avatarURL, - 'redirect' => !is_null($this->redirect) ? ($this->redirect ? 'true' : 'false') : $this->redirect, - 'guest' => !is_null($this->guest) ? ($this->guest ? 'true' : 'false') : $this->guest, - 'defaultLayout' => $this->defaultLayout, - ]; + $queries = $this->toApiDataArray(); foreach ($this->customParameters as $key => $value) { $queries[$key] = $value; diff --git a/src/Parameters/MetaParameters.php b/src/Parameters/MetaParameters.php index a97b158f..7869a475 100644 --- a/src/Parameters/MetaParameters.php +++ b/src/Parameters/MetaParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -25,25 +25,15 @@ */ abstract class MetaParameters extends BaseParameters { - /** - * @var array - */ + /** @var array */ private array $meta = []; - /** - * @return mixed - */ - public function getMeta(string $key) + public function getMeta(string $key): mixed { return $this->meta[$key]; } - /** - * @param mixed $value - * - * @return $this - */ - public function addMeta(string $key, $value) + public function addMeta(string $key, mixed $value): static { $this->meta[$key] = $value; @@ -51,18 +41,20 @@ public function addMeta(string $key, $value) } /** - * @param mixed $queries + * @param array $array + * + * @return array */ - protected function buildMeta(&$queries): void + protected function buildMeta(array $array): array { - if (0 !== count($this->meta)) { - foreach ($this->meta as $key => $value) { - if (!is_bool($value)) { - $queries['meta_' . $key] = $value; - } else { - $queries['meta_' . $key] = $value ? 'true' : 'false'; - } + foreach ($this->meta as $key => $value) { + if (is_bool($value)) { + $value = $value ? 'true' : 'false'; } + + $array['meta_' . $key] = $value; } + + return $array; } } diff --git a/src/Parameters/PublishRecordingsParameters.php b/src/Parameters/PublishRecordingsParameters.php index ecb9b5a7..f8525c4e 100644 --- a/src/Parameters/PublishRecordingsParameters.php +++ b/src/Parameters/PublishRecordingsParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,21 +20,24 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class PublishRecordingsParameters. */ class PublishRecordingsParameters extends BaseParameters { - private ?string $recordingId = null; + private string $recordingId; - private ?bool $publish = null; + private bool $publish; - public function __construct(string $recordingId, ?bool $publish = null) + public function __construct(string $recordingId, bool $publish) { $this->recordingId = $recordingId; $this->publish = $publish; } + #[ApiParameterMapper(attributeName: 'recordID')] public function getRecordingId(): ?string { return $this->recordingId; @@ -47,6 +50,7 @@ public function setRecordingId(string $recordingId): self return $this; } + #[ApiParameterMapper(attributeName: 'publish')] public function isPublish(): ?bool { return $this->publish; @@ -58,14 +62,4 @@ public function setPublish(bool $publish): self return $this; } - - public function getHTTPQuery(): string - { - return $this->buildHTTPQuery( - [ - 'recordID' => $this->recordingId, - 'publish' => !is_null($this->publish) ? ($this->publish ? 'true' : 'false') : $this->publish, - ] - ); - } } diff --git a/src/Parameters/PutRecordingTextTrackParameters.php b/src/Parameters/PutRecordingTextTrackParameters.php index eae808ba..d8f3fa7e 100644 --- a/src/Parameters/PutRecordingTextTrackParameters.php +++ b/src/Parameters/PutRecordingTextTrackParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,23 +20,25 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class PutRecordingTextTrackParameters. */ class PutRecordingTextTrackParameters extends BaseParameters { - private ?string $recordId = null; + private string $recordId; - private ?string $kind = null; + private string $kind; - private ?string $lang = null; + private string $lang; - private ?string $label = null; + private string $label; /** * PutRecordingTextTrackParameters constructor. */ - public function __construct(string $recordId = null, string $kind = null, string $lang = null, string $label = null) + public function __construct(string $recordId, string $kind, string $lang, string $label) { $this->recordId = $recordId; $this->kind = $kind; @@ -44,6 +46,7 @@ public function __construct(string $recordId = null, string $kind = null, string $this->label = $label; } + #[ApiParameterMapper(attributeName: 'recordID')] public function getRecordId(): ?string { return $this->recordId; @@ -56,6 +59,7 @@ public function setRecordId(string $recordId): self return $this; } + #[ApiParameterMapper(attributeName: 'kind')] public function getKind(): ?string { return $this->kind; @@ -68,6 +72,7 @@ public function setKind(string $kind): self return $this; } + #[ApiParameterMapper(attributeName: 'lang')] public function getLang(): ?string { return $this->lang; @@ -80,6 +85,7 @@ public function setLang(string $lang): self return $this; } + #[ApiParameterMapper(attributeName: 'label')] public function getLabel(): ?string { return $this->label; @@ -91,16 +97,4 @@ public function setLabel(string $label): self return $this; } - - public function getHTTPQuery(): string - { - $queries = [ - 'recordID' => $this->recordId, - 'kind' => $this->kind, - 'lang' => $this->lang, - 'label' => $this->label, - ]; - - return $this->buildHTTPQuery($queries); - } } diff --git a/src/Parameters/SendChatMessageParameters.php b/src/Parameters/SendChatMessageParameters.php new file mode 100644 index 00000000..c7d4d325 --- /dev/null +++ b/src/Parameters/SendChatMessageParameters.php @@ -0,0 +1,91 @@ +. + */ + +namespace BigBlueButton\Parameters; + +use BigBlueButton\Attribute\ApiParameterMapper; + +/** + * Class SendChatMessageParameters. + */ +class SendChatMessageParameters extends MetaParameters +{ + private string $meetingId; + + private string $message; + + private ?string $userName = null; + + /** + * CreateMeetingParameters constructor. + */ + public function __construct(string $meetingId, string $message) + { + $this->meetingId = $meetingId; + $this->message = $message; + } + + #[ApiParameterMapper(attributeName: 'meetingID')] + public function getMeetingId(): string + { + return $this->meetingId; + } + + public function setMeetingId(string $meetingId): self + { + $this->meetingId = $meetingId; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'message')] + public function getMessage(): string + { + return $this->message; + } + + public function setMessage(string $message): self + { + $this->message = $message; + + return $this; + } + + #[ApiParameterMapper(attributeName: 'userName')] + public function getUserName(): ?string + { + return $this->userName; + } + + public function setUserName(string $userName): self + { + $this->userName = $userName; + + return $this; + } + + public function getHTTPQuery(): string + { + $queries = $this->toApiDataArray(); + $queries = $this->buildMeta($queries); + + return $this->buildHTTPQuery($queries); + } +} diff --git a/src/Parameters/UpdateRecordingsParameters.php b/src/Parameters/UpdateRecordingsParameters.php index b36109c1..15f8d88e 100644 --- a/src/Parameters/UpdateRecordingsParameters.php +++ b/src/Parameters/UpdateRecordingsParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,18 +20,21 @@ namespace BigBlueButton\Parameters; +use BigBlueButton\Attribute\ApiParameterMapper; + /** * Class UpdateRecordingsParameters. */ class UpdateRecordingsParameters extends MetaParameters { - private ?string $recordingId = null; + private string $recordingId; - public function __construct(string $recordingId = null) + public function __construct(string $recordingId) { $this->recordingId = $recordingId; } + #[ApiParameterMapper(attributeName: 'recordID')] public function getRecordingId(): ?string { return $this->recordingId; @@ -46,11 +49,8 @@ public function setRecordingId(string $recordingId): self public function getHTTPQuery(): string { - $queries = [ - 'recordID' => $this->recordingId, - ]; - - $this->buildMeta($queries); + $queries = $this->toApiDataArray(); + $queries = $this->buildMeta($queries); return $this->buildHTTPQuery($queries); } diff --git a/src/Parameters/UserDataParameters.php b/src/Parameters/UserDataParameters.php index e768365a..15ca4a7b 100644 --- a/src/Parameters/UserDataParameters.php +++ b/src/Parameters/UserDataParameters.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -22,43 +22,30 @@ abstract class UserDataParameters extends BaseParameters { - /** - * @var array - */ + /** @var array */ private array $userData = []; - /** - * @return mixed - */ - public function getUserData(string $key) + public function getUserData(string $key): mixed { return $this->userData[$key]; } - /** - * @param mixed $value - * - * @return $this - */ - public function addUserData(string $key, $value): self + public function addUserData(string $key, mixed $value): static { $this->userData[$key] = $value; return $this; } - /** - * @param mixed $queries - */ - protected function buildUserData(&$queries): void + protected function buildUserData(mixed &$queries): void { - if (0 !== count($this->userData)) { - foreach ($this->userData as $key => $value) { - if (!is_bool($value)) { - $queries['userdata-' . $key] = $value; - } else { - $queries['userdata-' . $key] = $value ? 'true' : 'false'; - } + foreach ($this->userData as $key => $value) { + $queryKey = 'userdata-' . $key; + + if (is_bool($value)) { + $queries[$queryKey] = $value ? 'true' : 'false'; + } else { + $queries[$queryKey] = (string) $value; } } } diff --git a/src/Responses/ApiVersionResponse.php b/src/Responses/ApiVersionResponse.php index f33171ff..a49cc8bf 100644 --- a/src/Responses/ApiVersionResponse.php +++ b/src/Responses/ApiVersionResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -27,16 +27,16 @@ class ApiVersionResponse extends BaseResponse { public function getVersion(): string { - return $this->rawXml->version->__toString(); + return (string) $this->rawXml->version; } public function getApiVersion(): string { - return $this->rawXml->apiVersion->__toString(); + return (string) $this->rawXml->apiVersion; } public function getBbbVersion(): string { - return $this->rawXml->bbbVersion->__toString(); + return (string) $this->rawXml->bbbVersion; } } diff --git a/src/Responses/BaseJsonResponse.php b/src/Responses/BaseJsonResponse.php index efbc098b..07238846 100644 --- a/src/Responses/BaseJsonResponse.php +++ b/src/Responses/BaseJsonResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -27,15 +27,19 @@ abstract class BaseJsonResponse { public const SUCCESS = 'SUCCESS'; public const FAILED = 'FAILED'; - - /** - * @var mixed - */ - protected $data; + protected mixed $data; public function __construct(string $json) { $this->data = json_decode($json); + + if (JSON_ERROR_NONE !== json_last_error()) { + throw new \RuntimeException('Invalid JSON response: ' . json_last_error_msg()); + } + + if (!isset($this->data->response)) { + throw new \RuntimeException('Invalid JSON response structure: missing response field'); + } } /** diff --git a/src/Responses/BaseResponse.php b/src/Responses/BaseResponse.php index 35b0cc8e..09951a3c 100644 --- a/src/Responses/BaseResponse.php +++ b/src/Responses/BaseResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -45,17 +45,17 @@ public function getRawXml(): \SimpleXMLElement public function getReturnCode(): string { - return $this->rawXml->returncode->__toString(); + return $this->rawXml->returncode?->__toString() ?? ''; } public function getMessageKey(): string { - return $this->rawXml->messageKey->__toString(); + return $this->rawXml->messageKey?->__toString() ?? ''; } public function getMessage(): string { - return $this->rawXml->message->__toString(); + return $this->rawXml->message?->__toString() ?? ''; } public function success(): bool diff --git a/src/Responses/CreateMeetingResponse.php b/src/Responses/CreateMeetingResponse.php index edf28bf3..866b277d 100644 --- a/src/Responses/CreateMeetingResponse.php +++ b/src/Responses/CreateMeetingResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -27,27 +27,27 @@ class CreateMeetingResponse extends BaseResponse { public function getMeetingId(): string { - return $this->rawXml->meetingID->__toString(); + return (string) $this->rawXml->meetingID; } public function getInternalMeetingId(): string { - return $this->rawXml->internalMeetingID->__toString(); + return (string) $this->rawXml->internalMeetingID; } public function getParentMeetingId(): string { - return $this->rawXml->parentMeetingID->__toString(); + return (string) $this->rawXml->parentMeetingID; } public function getAttendeePassword(): string { - return $this->rawXml->attendeePW->__toString(); + return (string) $this->rawXml->attendeePW; } public function getModeratorPassword(): string { - return $this->rawXml->moderatorPW->__toString(); + return (string) $this->rawXml->moderatorPW; } /** @@ -65,7 +65,7 @@ public function getVoiceBridge(): int public function getDialNumber(): string { - return $this->rawXml->dialNumber->__toString(); + return (string) $this->rawXml->dialNumber; } /** @@ -73,12 +73,12 @@ public function getDialNumber(): string */ public function getCreationDate(): string { - return $this->rawXml->createDate->__toString(); + return (string) $this->rawXml->createDate; } public function hasUserJoined(): bool { - return 'true' === $this->rawXml->hasUserJoined->__toString(); + return 'true' === (string) $this->rawXml->hasUserJoined; } public function getDuration(): int @@ -88,6 +88,6 @@ public function getDuration(): int public function hasBeenForciblyEnded(): bool { - return 'true' === $this->rawXml->hasBeenForciblyEnded->__toString(); + return 'true' === (string) $this->rawXml->hasBeenForciblyEnded; } } diff --git a/src/Responses/DeleteRecordingsResponse.php b/src/Responses/DeleteRecordingsResponse.php index e08ff089..6a16bae2 100644 --- a/src/Responses/DeleteRecordingsResponse.php +++ b/src/Responses/DeleteRecordingsResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -27,6 +27,6 @@ class DeleteRecordingsResponse extends BaseResponse { public function isDeleted(): bool { - return 'true' === $this->rawXml->deleted->__toString(); + return 'true' === (string) $this->rawXml->deleted; } } diff --git a/src/Responses/EndMeetingResponse.php b/src/Responses/EndMeetingResponse.php index bbf0078f..0a20cb8f 100644 --- a/src/Responses/EndMeetingResponse.php +++ b/src/Responses/EndMeetingResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -27,11 +27,11 @@ class EndMeetingResponse extends BaseResponse { public function getMessageKey(): string { - return $this->rawXml->messageKey->__toString(); + return (string) $this->rawXml->messageKey; } public function getMessage(): string { - return $this->rawXml->message->__toString(); + return (string) $this->rawXml->message; } } diff --git a/src/Responses/FeedbackResponse.php b/src/Responses/FeedbackResponse.php new file mode 100644 index 00000000..06c4fd74 --- /dev/null +++ b/src/Responses/FeedbackResponse.php @@ -0,0 +1,112 @@ +. + */ + +namespace BigBlueButton\Responses; + +/** + * Class FeedbackResponse. + * + * Response for the feedback API call. + * Contains information about the feedback submission status. + * This response is returned in JSON format. + */ +class FeedbackResponse extends BaseJsonResponse +{ + public function getFeedbackID(): ?string + { + return $this->data->response->feedback_id ?? null; + } + + public function getSessionToken(): ?string + { + return $this->data->response->session_token ?? null; + } + + public function getMeetingID(): ?string + { + return $this->data->response->meeting_id ?? null; + } + + public function getUserID(): ?string + { + return $this->data->response->user_id ?? null; + } + + public function getRating(): ?int + { + $rating = $this->data->response->rating ?? null; + + return null !== $rating ? (int) $rating : null; + } + + public function getComment(): ?string + { + return $this->data->response->comment ?? null; + } + + public function getSubmittedAt(): ?string + { + return $this->data->response->submitted_at ?? null; + } + + public function getProcessed(): bool + { + return $this->data->response->processed ?? false; + } + + public function getFeedbackType(): ?string + { + return $this->data->response->feedback_type ?? null; + } + + public function getAdditionalData(): array + { + $additionalData = $this->data->response->additional_data ?? null; + + if (null === $additionalData) { + return []; + } + + return (array) $additionalData; + } + + /** + * Get a specific additional data field. + * + * @param string $key The data field key + * @param null|string $default Default value if key doesn't exist + */ + public function getAdditionalDataField(string $key, ?string $default = null): ?string + { + $data = $this->getAdditionalData(); + + return $data[$key] ?? $default; + } + + public function getStatus(): ?string + { + return $this->data->response->status ?? null; + } + + public function getStatusCode(): ?string + { + return $this->data->response->statuscode ?? null; + } +} diff --git a/src/Responses/GetJoinUrlResponse.php b/src/Responses/GetJoinUrlResponse.php new file mode 100644 index 00000000..3ccd3f9c --- /dev/null +++ b/src/Responses/GetJoinUrlResponse.php @@ -0,0 +1,134 @@ +. + */ + +namespace BigBlueButton\Responses; + +/** + * Class GetJoinUrlResponse. + * + * Response for the getJoinUrl API call. + * Contains the generated join URL and related session information. + */ +class GetJoinUrlResponse extends BaseResponse +{ + public function getUrl(): string + { + return (string) $this->rawXml->url; + } + + public function getSessionToken(): string + { + return (string) $this->rawXml->session_token; + } + + public function getUserId(): string + { + return (string) $this->rawXml->user_id; + } + + public function getMeetingId(): string + { + return (string) $this->rawXml->meeting_id; + } + + public function getAuthToken(): string + { + return (string) $this->rawXml->auth_token; + } + + public function getGuestStatus(): string + { + return (string) $this->rawXml->guestStatus; + } + + public function getUserName(): string + { + return (string) $this->rawXml->user_name; + } + + public function getCreatedTime(): string + { + return (string) $this->rawXml->created_time; + } + + public function getRedirectUrl(): ?string + { + $redirectUrl = $this->rawXml->redirect_url ?? null; + + return $redirectUrl ? (string) $redirectUrl : null; + } + + public function getSessionName(): ?string + { + $sessionName = $this->rawXml->session_name ?? null; + + return $sessionName ? (string) $sessionName : null; + } + + public function isReplaceSession(): bool + { + return 'true' === (string) ($this->rawXml->replace_session ?? 'false'); + } + + public function getEnforceLayout(): ?string + { + $enforceLayout = $this->rawXml->enforce_layout ?? null; + + return $enforceLayout ? (string) $enforceLayout : null; + } + + public function getStatusCode(): ?string + { + $statusCode = $this->rawXml->statuscode ?? null; + + return $statusCode ? (string) $statusCode : null; + } + + /** + * Get all userdata parameters that were merged or overridden. + * + * @return array Associative array of userdata parameters + */ + public function getUserData(): array + { + $userData = []; + + if (isset($this->rawXml->userdata)) { + foreach ($this->rawXml->userdata->children() as $key => $value) { + $userData[(string) $key] = (string) $value; + } + } + + return $userData; + } + + /** + * Get a specific userdata parameter. + * + * @param string $key The userdata parameter key + * @param null|string $default Default value if key doesn't exist + */ + public function getUserDataParam(string $key, ?string $default = null): ?string + { + $userData = $this->getUserData(); + + return $userData[$key] ?? $default; + } +} diff --git a/src/Responses/GetMeetingInfoResponse.php b/src/Responses/GetMeetingInfoResponse.php index 7bb8a006..2ab702ce 100644 --- a/src/Responses/GetMeetingInfoResponse.php +++ b/src/Responses/GetMeetingInfoResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/GetMeetingsResponse.php b/src/Responses/GetMeetingsResponse.php index d1c668d8..cbf586f6 100644 --- a/src/Responses/GetMeetingsResponse.php +++ b/src/Responses/GetMeetingsResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/GetRecordingTextTracksResponse.php b/src/Responses/GetRecordingTextTracksResponse.php index 913ebf44..3e47e31d 100644 --- a/src/Responses/GetRecordingTextTracksResponse.php +++ b/src/Responses/GetRecordingTextTracksResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/GetRecordingsResponse.php b/src/Responses/GetRecordingsResponse.php index fcdcb20a..7c8e8870 100644 --- a/src/Responses/GetRecordingsResponse.php +++ b/src/Responses/GetRecordingsResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -27,6 +27,15 @@ */ class GetRecordingsResponse extends BaseResponse { + public function getTotalElements(): ?int + { + if (!$this->rawXml->totalElements) { + return null; + } + + return (int) $this->rawXml->totalElements->__toString(); + } + /** * @return Record[] */ diff --git a/src/Responses/HooksCreateResponse.php b/src/Responses/HooksCreateResponse.php index 3e92008d..30fe6b8d 100644 --- a/src/Responses/HooksCreateResponse.php +++ b/src/Responses/HooksCreateResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/HooksDestroyResponse.php b/src/Responses/HooksDestroyResponse.php index 76ca9994..8cd3bf53 100644 --- a/src/Responses/HooksDestroyResponse.php +++ b/src/Responses/HooksDestroyResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/HooksListResponse.php b/src/Responses/HooksListResponse.php index 9a69bedd..ded39fc1 100644 --- a/src/Responses/HooksListResponse.php +++ b/src/Responses/HooksListResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/InsertDocumentResponse.php b/src/Responses/InsertDocumentResponse.php index 04c87a89..1178d2a3 100644 --- a/src/Responses/InsertDocumentResponse.php +++ b/src/Responses/InsertDocumentResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/IsMeetingRunningResponse.php b/src/Responses/IsMeetingRunningResponse.php index e363028d..b555e9fa 100644 --- a/src/Responses/IsMeetingRunningResponse.php +++ b/src/Responses/IsMeetingRunningResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -27,6 +27,6 @@ class IsMeetingRunningResponse extends BaseResponse { public function isRunning(): bool { - return 'true' === $this->rawXml->running->__toString(); + return 'true' === (string) $this->rawXml->running; } } diff --git a/src/Responses/JoinMeetingResponse.php b/src/Responses/JoinMeetingResponse.php index 5aa0f9dc..e2127d14 100644 --- a/src/Responses/JoinMeetingResponse.php +++ b/src/Responses/JoinMeetingResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/PublishRecordingsResponse.php b/src/Responses/PublishRecordingsResponse.php index 8f920a57..1b9e8bff 100644 --- a/src/Responses/PublishRecordingsResponse.php +++ b/src/Responses/PublishRecordingsResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/PutRecordingTextTrackResponse.php b/src/Responses/PutRecordingTextTrackResponse.php index b3df4dc5..163e1a14 100644 --- a/src/Responses/PutRecordingTextTrackResponse.php +++ b/src/Responses/PutRecordingTextTrackResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Responses/SendChatMessageResponse.php b/src/Responses/SendChatMessageResponse.php new file mode 100644 index 00000000..a0094fa8 --- /dev/null +++ b/src/Responses/SendChatMessageResponse.php @@ -0,0 +1,26 @@ +. + */ + +namespace BigBlueButton\Responses; + +/** + * Class PublishRecordingsResponse. + */ +class SendChatMessageResponse extends BaseResponse {} diff --git a/src/Responses/UpdateRecordingsResponse.php b/src/Responses/UpdateRecordingsResponse.php index d9bb5cc4..285b0203 100644 --- a/src/Responses/UpdateRecordingsResponse.php +++ b/src/Responses/UpdateRecordingsResponse.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/src/Util/UrlBuilder.php b/src/Util/UrlBuilder.php index f4399b8d..11207a3a 100644 --- a/src/Util/UrlBuilder.php +++ b/src/Util/UrlBuilder.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -25,6 +25,8 @@ use BigBlueButton\Parameters\CreateMeetingParameters; use BigBlueButton\Parameters\DeleteRecordingsParameters; use BigBlueButton\Parameters\EndMeetingParameters; +use BigBlueButton\Parameters\FeedbackParameters; +use BigBlueButton\Parameters\GetJoinUrlParameters; use BigBlueButton\Parameters\GetMeetingInfoParameters; use BigBlueButton\Parameters\GetRecordingsParameters; use BigBlueButton\Parameters\GetRecordingTextTracksParameters; @@ -35,32 +37,89 @@ use BigBlueButton\Parameters\JoinMeetingParameters; use BigBlueButton\Parameters\PublishRecordingsParameters; use BigBlueButton\Parameters\PutRecordingTextTrackParameters; +use BigBlueButton\Parameters\SendChatMessageParameters; use BigBlueButton\Parameters\UpdateRecordingsParameters; class UrlBuilder { /** @deprecated Property will be private soon. Use setter/getter instead. */ - protected string $hashingAlgorithm; + protected HashingAlgorithm $hashingAlgorithm; private string $secret; private string $baseUrl; - public function __construct(string $secret, string $baseUrl, string $hashingAlgorithm) - { + public function __construct( + #[\SensitiveParameter] + string $secret, + string $baseUrl, + HashingAlgorithm $hashingAlgorithm, + ) { $this->setSecret($secret); $this->setBaseUrl($baseUrl); $this->setHashingAlgorithm($hashingAlgorithm); } + /** + * Creates a new instance from environment variables. + * + * The optional parameters allow to specify some of the values, while the + * remaining values fall back to environment variables or to a default + * value. + * + * This method only exists to BC-support creating a BigBlueButton class + * without injecting the UrlBuilder instance. + * + * @internal + */ + public static function fromEnvVars( + ?string $secret = null, + ?string $baseUrl = null, + ?HashingAlgorithm $hashingAlgorithm = null, + ): static { + $secret ??= getenv('BBB_SECRET') ?: getenv('BBB_SECURITY_SALT'); + + if (false === $secret) { + throw new \RuntimeException("No BBB-Secret (or BBB-Salt) found! Please provide it either in constructor (2nd argument) or by environment variable 'BBB_SECRET' (or 'BBB_SECURITY_SALT')!"); + } + + $baseUrl ??= getenv('BBB_SERVER_BASE_URL'); + + if (false === $baseUrl) { + throw new \RuntimeException('No BBB-Server-Url found! Please provide it either in constructor ' . "(1st argument) or by environment variable 'BBB_SERVER_BASE_URL'!"); + } + + $hashingAlgorithm ??= HashingAlgorithm::SHA_256; + + // Extending classes need to override this method, if they change the + // constructor signature. + // @phpstan-ignore new.static + return new static($secret, $baseUrl, $hashingAlgorithm); + } + // Getters & Setters - public function setSecret(string $secret): self - { + public function setSecret( + #[\SensitiveParameter] + string $secret, + ): self { $this->secret = $secret; return $this; } + /** + * Gets the secret. + * + * This method only exists to support a deprecated property in the + * BigBlueButton class. + * + * @internal + */ + public function getSecret(): string + { + return $this->secret; + } + public function setBaseUrl(string $baseUrl): self { // add tailing dir-separator if missing @@ -73,14 +132,27 @@ public function setBaseUrl(string $baseUrl): self return $this; } - public function setHashingAlgorithm(string $hashingAlgorithm): self + /** + * Gets the base url. + * + * This method only exists to support a deprecated property in the + * BigBlueButton class. + * + * @internal + */ + public function getBaseUrl(): string + { + return $this->baseUrl; + } + + public function setHashingAlgorithm(HashingAlgorithm $hashingAlgorithm): self { $this->hashingAlgorithm = $hashingAlgorithm; return $this; } - public function getHashingAlgorithm(): string + public function getHashingAlgorithm(): HashingAlgorithm { return $this->hashingAlgorithm; } @@ -102,7 +174,7 @@ public function buildUrl(string $method = '', string $params = '', bool $append */ public function buildQs(string $method = '', string $params = ''): string { - return $params . '&checksum=' . hash($this->hashingAlgorithm, $method . $params . $this->secret); + return $params . '&checksum=' . hash($this->hashingAlgorithm->value, $method . $params . $this->secret); } // URL-Generators @@ -116,6 +188,11 @@ public function getJoinMeetingURL(JoinMeetingParameters $joinMeetingParams): str return $this->buildUrl(ApiMethod::JOIN, $joinMeetingParams->getHTTPQuery()); } + public function getGetJoinUrlUrl(GetJoinUrlParameters $getJoinUrlParams): string + { + return $this->buildUrl(ApiMethod::GET_JOIN_URL, $getJoinUrlParams->getHTTPQuery()); + } + public function getEndMeetingURL(EndMeetingParameters $endParams): string { return $this->buildUrl(ApiMethod::END, $endParams->getHTTPQuery()); @@ -126,6 +203,16 @@ public function getInsertDocumentUrl(InsertDocumentParameters $insertDocumentPar return $this->buildUrl(ApiMethod::INSERT_DOCUMENT, $insertDocumentParameters->getHTTPQuery()); } + public function getSendChatMessageUrl(SendChatMessageParameters $sendChatMessageParameters): string + { + return $this->buildUrl(ApiMethod::SEND_CHAT_MESSAGE, $sendChatMessageParameters->getHTTPQuery()); + } + + public function getFeedbackUrl(FeedbackParameters $feedbackParameters): string + { + return $this->buildUrl(ApiMethod::FEEDBACK, $feedbackParameters->getHTTPQuery()); + } + public function getIsMeetingRunningUrl(IsMeetingRunningParameters $meetingParams): string { return $this->buildUrl(ApiMethod::IS_MEETING_RUNNING, $meetingParams->getHTTPQuery()); @@ -260,11 +347,13 @@ public function getHooksDestroyUrl(HooksDestroyParameters $hooksDestroyParams): * * @deprecated This function will evolve in phases and will later disappear */ - private function getHashingAlgorithmForHooks(): string + private function getHashingAlgorithmForHooks(): HashingAlgorithm { // ---------------------------------- phase 1 ---------------------------------- // in case this env-variable is not set, SHA1 shall be used as default (phase 1) - return getenv('HASH_ALGO_FOR_HOOKS') ?: HashingAlgorithm::SHA_1; + $hashValue = getenv('HASH_ALGO_FOR_HOOKS') ?: HashingAlgorithm::SHA_1->value; + + return HashingAlgorithm::from($hashValue); // ---------------------------------- phase 1 ---------------------------------- /* ---------------------------------- phase 2 ---------------------------------- diff --git a/tests/BigBlueButtonTest.php b/tests/BigBlueButtonTest.php index 57799876..f9b4e7a9 100644 --- a/tests/BigBlueButtonTest.php +++ b/tests/BigBlueButtonTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -21,6 +21,9 @@ namespace BigBlueButton; use BigBlueButton\Core\ApiMethod; +use BigBlueButton\Core\DocumentFile; +use BigBlueButton\Core\DocumentUrl; +use BigBlueButton\Enum\Feature; use BigBlueButton\Parameters\CreateMeetingParameters; use BigBlueButton\Parameters\DeleteRecordingsParameters; use BigBlueButton\Parameters\EndMeetingParameters; @@ -28,8 +31,10 @@ use BigBlueButton\Parameters\GetRecordingsParameters; use BigBlueButton\Parameters\HooksCreateParameters; use BigBlueButton\Parameters\HooksDestroyParameters; +use BigBlueButton\Parameters\InsertDocumentParameters; use BigBlueButton\Parameters\IsMeetingRunningParameters; use BigBlueButton\Parameters\PublishRecordingsParameters; +use BigBlueButton\Parameters\SendChatMessageParameters; use BigBlueButton\TestServices\EnvLoader; use BigBlueButton\TestServices\Fixtures; use BigBlueButton\TestServices\ParamsIterator; @@ -97,7 +102,7 @@ public function testCreateMeetingUrl(): void $params = Fixtures::generateCreateParams(); $url = $this->bbb->getCreateMeetingUrl(Fixtures::getCreateMeetingParametersMock($params)); - $paramsIterator = new ParamsIterator(); + $paramsIterator = new ParamsIterator('testCreateMeetingUrl'); $paramsIterator->iterate($params, $url); } @@ -115,9 +120,9 @@ public function testCreateMeeting(): void } /** - * Test create meeting with a document URL. + * Test create meeting with a presentation URL. */ - public function testCreateMeetingWithDocumentUrl(): void + public function testCreateMeetingWithPresentationUrl(): void { $params = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); $params->addPresentation('https://picsum.photos/3840/2160/?random'); @@ -130,9 +135,9 @@ public function testCreateMeetingWithDocumentUrl(): void } /** - * Test create meeting with a document URL and filename. + * Test create meeting with a presentation URL and filename. */ - public function testCreateMeetingWithDocumentUrlAndFileName(): void + public function testCreateMeetingWithPresentationUrlAndFileName(): void { $params = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); $params->addPresentation('https://picsum.photos/3840/2160/?random', null, 'placeholder.png'); @@ -145,13 +150,15 @@ public function testCreateMeetingWithDocumentUrlAndFileName(): void } /** - * Test create meeting with a document URL. + * Test create meeting with a presentation embedded. */ - public function testCreateMeetingWithDocumentEmbedded(): void + public function testCreateMeetingWithPresentationEmbedded(): void { - $params = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $content = file_get_contents(Fixtures::IMAGE_PATH . 'bbb_logo.png'); + $this->assertIsString($content); - $params->addPresentation('bbb_logo.png', file_get_contents(__DIR__ . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'bbb_logo.png')); + $params = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $params->addPresentation('bbb_logo.png', $content); $result = $this->bbb->createMeeting($params); @@ -161,13 +168,16 @@ public function testCreateMeetingWithDocumentEmbedded(): void } /** - * Test create meeting with a multiple documents. + * Test create meeting with a multiple presentations. */ - public function testCreateMeetingWithMultiDocument(): void + public function testCreateMeetingWithMultiPresentations(): void { + $content = file_get_contents(Fixtures::IMAGE_PATH . 'bbb_logo.png'); + $this->assertIsString($content); + $params = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); $params->addPresentation('https://picsum.photos/3840/2160/?random', null, 'presentation.png'); - $params->addPresentation('logo.png', file_get_contents(__DIR__ . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'bbb_logo.png')); + $params->addPresentation('logo.png', $content); $result = $this->bbb->createMeeting($params); @@ -176,6 +186,187 @@ public function testCreateMeetingWithMultiDocument(): void $this->assertTrue($result->success()); } + /** + * Test create meeting with Document (Url). + */ + public function testCreateMeetingWithDocumentUrl(): void + { + // ARRANGE + $url = 'https://picsum.photos/3840/2160/?random'; + $filename = 'picture.jpg'; + $document = new DocumentUrl($url, $filename); + $createMeetingParameters = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $createMeetingParameters->addDocument($document); + + // ACT + $createMeetingResponse = $this->bbb->createMeeting($createMeetingParameters); + + // ASSERT + $this->assertCount(1, $createMeetingParameters->getDocuments()); + $this->assertTrue($createMeetingResponse->success()); + } + + /** + * Test create meeting with Document (File). + */ + public function testCreateMeetingWithDocumentFile(): void + { + // ARRANGE + $filepath = Fixtures::IMAGE_PATH . 'bbb_logo.png'; + $filename = 'picture.png'; + $document = new DocumentFile($filepath, $filename); + $createMeetingParameters = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $createMeetingParameters->addDocument($document); + + // ACT + $createMeetingResponse = $this->bbb->createMeeting($createMeetingParameters); + + // ASSERT + $this->assertCount(1, $createMeetingParameters->getDocuments()); + $this->assertTrue($createMeetingResponse->success()); + } + + /** + * Test create meeting with Document (URL and File). + */ + public function testCreateMeetingWithDocumentUrlAndFile(): void + { + // ARRANGE + // file 1 + $url = 'https://picsum.photos/3840/2160/?random'; + $filename = 'picture.jpg'; + $documentUrl = new DocumentUrl($url, $filename); + + // file 2 + $filepath = Fixtures::IMAGE_PATH . 'bbb_logo.png'; + $filename = 'picture.png'; + $documentFile = new DocumentFile($filepath, $filename); + + $createMeetingParameters = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $createMeetingParameters + ->addDocument($documentFile) + ->addDocument($documentUrl) + ; + + // ACT + $createMeetingResponse = $this->bbb->createMeeting($createMeetingParameters); + + // ASSERT + $this->assertCount(2, $createMeetingParameters->getDocuments()); + $this->assertTrue($createMeetingResponse->success()); + } + + // Insert Document + + /** + * Test insert document (URL) into existing meeting. + */ + public function testInsertDocumentUrl(): void + { + // ARRANGE + $url = 'https://picsum.photos/3840/2160/?random'; + $filename = 'picture.jpg'; + $document = new DocumentUrl($url, $filename); + $createMeetingParameters = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $createMeetingResponse = $this->bbb->createMeeting($createMeetingParameters); + $insertDocumentParameters = new InsertDocumentParameters((string) $createMeetingParameters->getMeetingId()); + $insertDocumentParameters->addDocument($document); + + // PRE-CHECK + $this->assertCount(1, $insertDocumentParameters->getDocuments()); + $this->assertTrue($createMeetingResponse->success()); + + // ACT + $insertDocumentResponse = $this->bbb->insertDocument($insertDocumentParameters); + + // ASSERT + if (!$this->isFeatureDisabled(Feature::PRESENTATION, $createMeetingParameters)) { + $this->assertTrue($insertDocumentResponse->success()); + } else { + $this->assertTrue($insertDocumentResponse->failed()); + } + } + + /** + * Test insert document (FILE) into existing meeting. + */ + public function testInsertDocumentFile(): void + { + // ARRANGE + $filepath = Fixtures::IMAGE_PATH . 'bbb_logo.png'; + $filename = 'picture.png'; + $document = new DocumentFile($filepath, $filename); + $createMeetingParameters = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $createMeetingResponse = $this->bbb->createMeeting($createMeetingParameters); + $insertDocumentParameters = new InsertDocumentParameters((string) $createMeetingParameters->getMeetingId()); + $insertDocumentParameters->addDocument($document); + + // PRE-CHECK + $this->assertCount(1, $insertDocumentParameters->getDocuments()); + $this->assertTrue($createMeetingResponse->success()); + + // ACT + $insertDocumentResponse = $this->bbb->insertDocument($insertDocumentParameters); + + // ASSERT + if (!$this->isFeatureDisabled(Feature::PRESENTATION, $createMeetingParameters)) { + $this->assertTrue($insertDocumentResponse->success()); + } else { + $this->assertTrue($insertDocumentResponse->failed()); + } + } + + /** + * Test insert document (URL and FILE) into existing meeting. + */ + public function testInsertDocumentUrlAndFile(): void + { + // ARRANGE + $url = 'https://picsum.photos/3840/2160/?random'; + $filename = 'picture.jpg'; + $documentUrl = new DocumentUrl($url, $filename); + + // file 2 + $filepath = Fixtures::IMAGE_PATH . 'bbb_logo.png'; + $filename = 'picture.png'; + $documentFile = new DocumentFile($filepath, $filename); + + $createMeetingParameters = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $createMeetingResponse = $this->bbb->createMeeting($createMeetingParameters); + $insertDocumentParameters = new InsertDocumentParameters((string) $createMeetingParameters->getMeetingId()); + $insertDocumentParameters + ->addDocument($documentUrl) + ->addDocument($documentFile) + ; + + // PRE-CHECK + $this->assertCount(2, $insertDocumentParameters->getDocuments()); + $this->assertTrue($createMeetingResponse->success()); + + // ACT + $insertDocumentResponse = $this->bbb->insertDocument($insertDocumentParameters); + + // ASSERT + if (!$this->isFeatureDisabled(Feature::PRESENTATION, $createMeetingParameters)) { + $this->assertTrue($insertDocumentResponse->success()); + } else { + $this->assertTrue($insertDocumentResponse->failed()); + } + } + + public function testSendChatMessage(): void + { + $createMeetingParameters = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); + $createMeetingResponse = $this->bbb->createMeeting($createMeetingParameters); + + $sendChatMessageParameters = new SendChatMessageParameters($createMeetingResponse->getMeetingId(), $this->faker->sentence()); + $sendChatMessageParameters->setUserName($this->faker->userName()); + $sendChatMessageResponse = $this->bbb->sendChatMessage($sendChatMessageParameters); + + // Even if the meeting exists, it returns failure because no user has already joined the meeting + $this->assertTrue($sendChatMessageResponse->failed()); + } + // Join Meeting /** @@ -190,7 +381,7 @@ public function testCreateJoinMeetingUrl(): void $joinMeetingMock = Fixtures::getJoinMeetingMock($joinMeetingParams); $url = $this->bbb->getJoinMeetingURL($joinMeetingMock); - $paramsIterator = new ParamsIterator(); + $paramsIterator = new ParamsIterator('testCreateJoinMeetingUrl'); $paramsIterator->iterate($joinMeetingParams, $url); } @@ -211,7 +402,7 @@ public function testJoinMeeting(): void $joinMeetingParams = Fixtures::generateJoinMeetingParams(); $joinMeetingMock = Fixtures::getJoinMeetingMock($joinMeetingParams); - // adapt to join the above created meeting + // adapt to join the above-created meeting $joinMeetingMock->setRedirect(false); $joinMeetingMock->setMeetingId($createMeetingResponse->getMeetingId()); $joinMeetingMock->setCreationTime($createMeetingResponse->getCreationTime()); @@ -243,7 +434,7 @@ public function testCreateEndMeetingUrl(): void { $params = Fixtures::generateEndMeetingParams(); $url = $this->bbb->getEndMeetingURL(Fixtures::getEndMeetingMock($params)); - $paramsIterator = new ParamsIterator(); + $paramsIterator = new ParamsIterator('testCreateEndMeetingUrl'); $paramsIterator->iterate($params, $url); } @@ -393,7 +584,7 @@ public function testUpdateRecordingsUrl(): void { $params = Fixtures::generateUpdateRecordingsParams(); $url = $this->bbb->getUpdateRecordingsUrl(Fixtures::getUpdateRecordingsParamsMock($params)); - $paramsIterator = new ParamsIterator(); + $paramsIterator = new ParamsIterator('testUpdateRecordingsUrl'); $paramsIterator->iterate($params, $url); } @@ -441,4 +632,13 @@ public function testHooksDestroy(): void $hooksCreateResponse = $this->bbb->hooksDestroy($hooksDestroyParameters); $this->assertFalse($hooksCreateResponse->success(), $hooksCreateResponse->getMessage()); } + + /** + * Checks whether a feature is disabled in meeting parameters. + */ + protected function isFeatureDisabled(Feature $feature, CreateMeetingParameters $createMeetingParameters): bool + { + return in_array($feature, $createMeetingParameters->getDisabledFeatures()) + && !in_array($feature, $createMeetingParameters->getDisabledFeaturesExclude()); + } } diff --git a/tests/CookieSecurityTest.php b/tests/CookieSecurityTest.php new file mode 100644 index 00000000..8d766f01 --- /dev/null +++ b/tests/CookieSecurityTest.php @@ -0,0 +1,206 @@ +. + */ + +namespace BigBlueButton; + +/** + * Test cookie security improvements. + * + * @internal + */ +class CookieSecurityTest extends TestCase +{ + private BigBlueButton $bbb; + + public function setUp(): void + { + parent::setUp(); + $this->bbb = new BigBlueButton('http://test.example.com', 'test-secret'); + } + + /** + * Test valid cookie format validation. + */ + public function testValidCookieFormat(): void + { + $reflection = new \ReflectionClass($this->bbb); + $method = $reflection->getMethod('isValidCookieFormat'); + $method->setAccessible(true); + + // Valid cookie formats + $validCookies = [ + 'JSESSIONID=ABC123DEF456', + 'JSESSIONID=ABC123DEF456; Path=/', + 'JSESSIONID=ABC123DEF456; Path=/; HttpOnly', + 'SESSIONID=test123; Secure; SameSite=Strict', + ]; + + foreach ($validCookies as $cookie) { + $this->assertTrue( + $method->invoke($this->bbb, $cookie), + "Valid cookie should pass: {$cookie}" + ); + } + } + + /** + * Test invalid cookie format rejection. + */ + public function testInvalidCookieFormatRejection(): void + { + $reflection = new \ReflectionClass($this->bbb); + $method = $reflection->getMethod('isValidCookieFormat'); + $method->setAccessible(true); + + // Invalid/dangerous cookie formats + $invalidCookies = [ + 'JSESSIONID=', + 'JSESSIONID=javascript:alert("xss")', + 'JSESSIONID=data:text/html,', + 'JSESSIONID=../../../etc/passwd', + 'JSESSIONID=' . str_repeat('A', 1000), // Too long + '', + 'invalid-format-without-equals', + ]; + + foreach ($invalidCookies as $cookie) { + $this->assertFalse( + $method->invoke($this->bbb, $cookie), + "Invalid cookie should be rejected: {$cookie}" + ); + } + } + + /** + * Test safe JSESSIONID extraction. + */ + public function testSafeJSessionIdExtraction(): void + { + $reflection = new \ReflectionClass($this->bbb); + $method = $reflection->getMethod('extractJSessionIdSafely'); + $method->setAccessible(true); + + // Valid JSESSIONID extraction + $validCookie = 'JSESSIONID=ABC123DEF456; Path=/'; + $sessionId = $method->invoke($this->bbb, $validCookie); + $this->assertEquals('ABC123DEF456', $sessionId); + + // Case insensitive extraction + $caseInsensitiveCookie = 'jsessionid=XYZ789ABC123'; + $sessionId = $method->invoke($this->bbb, $caseInsensitiveCookie); + $this->assertEquals('XYZ789ABC123', $sessionId); + + // No JSESSIONID present + $noSessionCookie = 'OTHERCOOKIE=value123'; + $sessionId = $method->invoke($this->bbb, $noSessionCookie); + $this->assertNull($sessionId); + } + + /** + * Test malicious JSESSIONID rejection. + */ + public function testMaliciousJSessionIdRejection(): void + { + $reflection = new \ReflectionClass($this->bbb); + $method = $reflection->getMethod('extractJSessionIdSafely'); + $method->setAccessible(true); + + // Malicious session IDs should be rejected + $maliciousCookies = [ + 'JSESSIONID=../../../etc/passwd', + 'JSESSIONID=', + 'JSESSIONID=javascript:alert("xss")', + 'JSESSIONID=' . str_repeat('A', 101), // Too long + 'JSESSIONID=invalid@chars#here', + ]; + + foreach ($maliciousCookies as $cookie) { + $sessionId = $method->invoke($this->bbb, $cookie); + $this->assertNull( + $sessionId, + "Malicious session ID should be rejected: {$cookie}" + ); + } + } + + /** + * Test JSESSIONID format validation. + */ + public function testJSessionIdFormatValidation(): void + { + $reflection = new \ReflectionClass($this->bbb); + $method = $reflection->getMethod('extractJSessionIdSafely'); + $method->setAccessible(true); + + // Valid formats + $validFormats = [ + 'JSESSIONID=ABC123', + 'JSESSIONID=abc123def456', + 'JSESSIONID=ABC_123-DEF.456', + 'JSESSIONID=' . str_repeat('A', 100), // Maximum length + ]; + + foreach ($validFormats as $cookie) { + $sessionId = $method->invoke($this->bbb, $cookie); + $this->assertNotNull( + $sessionId, + "Valid format should be accepted: {$cookie}" + ); + } + + // Invalid formats + $invalidFormats = [ + 'JSESSIONID=', // Empty + 'JSESSIONID=ABC@123', // Invalid character + 'JSESSIONID=ABC 123', // Space + 'JSESSIONID=' . str_repeat('A', 101), // Too long + ]; + + foreach ($invalidFormats as $cookie) { + $sessionId = $method->invoke($this->bbb, $cookie); + $this->assertNull( + $sessionId, + "Invalid format should be rejected: {$cookie}" + ); + } + } + + /** + * Test session ID validation directly. + */ + public function testSessionIdValidation(): void + { + $reflection = new \ReflectionClass($this->bbb); + $method = $reflection->getMethod('isValidSessionId'); + $method->setAccessible(true); + + // Valid session IDs + $validIds = ['ABC123', 'abc123def456', 'ABC_123-DEF.456', str_repeat('A', 100)]; + foreach ($validIds as $id) { + $this->assertTrue($method->invoke($this->bbb, $id), "Valid ID should pass: {$id}"); + } + + // Invalid session IDs + $invalidIds = ['', 'ABC@123', 'ABC 123', str_repeat('A', 101), '../../../etc/passwd']; + foreach ($invalidIds as $id) { + $this->assertFalse($method->invoke($this->bbb, $id), "Invalid ID should fail: {$id}"); + } + } +} diff --git a/tests/Core/ClientSettingsOverrideTest.php b/tests/Core/ClientSettingsOverrideTest.php new file mode 100644 index 00000000..d6f521f5 --- /dev/null +++ b/tests/Core/ClientSettingsOverrideTest.php @@ -0,0 +1,254 @@ +. + */ + +namespace BigBlueButton\Core; + +use BigBlueButton\TestCase; + +/** + * Class ClientSettingsOverrideTest. + * + * @internal + */ +class ClientSettingsOverrideTest extends TestCase +{ + public function testCreateClientSettingsOverride(): void + { + $settings = [ + 'public' => [ + 'kurento' => [ + 'wsUrl' => 'wss://test.bigbluebutton.org/bbb-webrtc-sfu', + ], + 'app' => [ + 'appName' => 'Test', + ], + ], + ]; + + $clientSettingsOverride = new ClientSettingsOverride($settings); + + $this->assertEquals($settings, $clientSettingsOverride->getSettings()); + } + + public function testCreateEmptyClientSettingsOverride(): void + { + $clientSettingsOverride = new ClientSettingsOverride(); + + $this->assertEquals([], $clientSettingsOverride->getSettings()); + } + + public function testSetAndGetSettings(): void + { + $clientSettingsOverride = new ClientSettingsOverride(); + + $settings = [ + 'public' => [ + 'app' => [ + 'appName' => 'New Test App', + ], + ], + ]; + + $clientSettingsOverride->setSettings($settings); + $this->assertEquals($settings, $clientSettingsOverride->getSettings()); + } + + public function testSetAndGetSetting(): void + { + $clientSettingsOverride = new ClientSettingsOverride(); + + // Test setting simple value + $clientSettingsOverride->setSetting('test.key', 'test value'); + $this->assertEquals('test value', $clientSettingsOverride->getSetting('test.key')); + + // Test setting nested value + $clientSettingsOverride->setSetting('public.app.appName', 'Test App'); + $this->assertEquals('Test App', $clientSettingsOverride->getSetting('public.app.appName')); + + // Test getting non-existent key + $this->assertNull($clientSettingsOverride->getSetting('non.existent.key')); + $this->assertEquals('default', $clientSettingsOverride->getSetting('non.existent.key', 'default')); + } + + public function testRemoveSetting(): void + { + $settings = [ + 'public' => [ + 'app' => [ + 'appName' => 'Test App', + 'version' => '1.0', + ], + ], + ]; + + $clientSettingsOverride = new ClientSettingsOverride($settings); + + $this->assertEquals('Test App', $clientSettingsOverride->getSetting('public.app.appName')); + $this->assertEquals('1.0', $clientSettingsOverride->getSetting('public.app.version')); + + // Remove a setting + $clientSettingsOverride->removeSetting('public.app.appName'); + $this->assertNull($clientSettingsOverride->getSetting('public.app.appName')); + $this->assertEquals('1.0', $clientSettingsOverride->getSetting('public.app.version')); + + // Remove non-existent setting (should not cause error) + $clientSettingsOverride->removeSetting('non.existent.key'); + } + + public function testToXML(): void + { + $settings = [ + 'public' => [ + 'kurento' => [ + 'wsUrl' => 'wss://test.bigbluebutton.org/bbb-webrtc-sfu', + ], + 'app' => [ + 'appName' => 'Test', + 'helpLink' => 'https://www.bigbluebutton.org', + ], + ], + ]; + + $clientSettingsOverride = new ClientSettingsOverride($settings); + $xml = $clientSettingsOverride->toXML(); + + $this->assertNotEmpty($xml); + $this->assertStringContainsString('', $xml); + $this->assertStringContainsString('', $xml); + $this->assertStringContainsString('', $xml); + $this->assertStringContainsString('', $xml); + $this->assertStringContainsString('assertStringContainsString('wss://test.bigbluebutton.org/bbb-webrtc-sfu', $xml); + $this->assertStringContainsString('Test', $xml); + $this->assertStringContainsString('https://www.bigbluebutton.org', $xml); + } + + public function testToXMLEmpty(): void + { + $clientSettingsOverride = new ClientSettingsOverride([]); + $xml = $clientSettingsOverride->toXML(); + + $this->assertEmpty($xml); + } + + public function testFromJson(): void + { + $settings = [ + 'public' => [ + 'app' => [ + 'appName' => 'Test App', + 'version' => '2.0', + ], + ], + ]; + + $json = json_encode($settings); + $clientSettingsOverride = ClientSettingsOverride::fromJson($json); + + $this->assertEquals($settings, $clientSettingsOverride->getSettings()); + } + + public function testFromJsonInvalid(): void + { + $this->expectException(\InvalidArgumentException::class); + $this->expectExceptionMessage('Invalid JSON string'); + + ClientSettingsOverride::fromJson('invalid json string'); + } + + public function testComplexNestedSettings(): void + { + $clientSettingsOverride = new ClientSettingsOverride(); + + // Set deeply nested values + $clientSettingsOverride->setSetting('level1.level2.level3.deep', 'deep value'); + $clientSettingsOverride->setSetting('level1.level2.another', 'another value'); + $clientSettingsOverride->setSetting('root', 'root value'); + + $this->assertEquals('deep value', $clientSettingsOverride->getSetting('level1.level2.level3.deep')); + $this->assertEquals('another value', $clientSettingsOverride->getSetting('level1.level2.another')); + $this->assertEquals('root value', $clientSettingsOverride->getSetting('root')); + + // Check the full structure + $expected = [ + 'level1' => [ + 'level2' => [ + 'level3' => [ + 'deep' => 'deep value', + ], + 'another' => 'another value', + ], + ], + 'root' => 'root value', + ]; + + $this->assertEquals($expected, $clientSettingsOverride->getSettings()); + } + + public function testOverrideExistingSetting(): void + { + $clientSettingsOverride = new ClientSettingsOverride([ + 'public' => [ + 'app' => [ + 'appName' => 'Original App', + ], + ], + ]); + + $this->assertEquals('Original App', $clientSettingsOverride->getSetting('public.app.appName')); + + // Override the existing setting + $clientSettingsOverride->setSetting('public.app.appName', 'New App Name'); + + $this->assertEquals('New App Name', $clientSettingsOverride->getSetting('public.app.appName')); + } + + public function testRemoveNestedSetting(): void + { + $clientSettingsOverride = new ClientSettingsOverride([ + 'public' => [ + 'app' => [ + 'appName' => 'Test App', + 'settings' => [ + 'theme' => 'dark', + 'language' => 'en', + ], + ], + 'kurento' => [ + 'wsUrl' => 'wss://test.example.com', + ], + ], + ]); + + // Remove a nested setting + $clientSettingsOverride->removeSetting('public.app.settings.theme'); + + $this->assertEquals('Test App', $clientSettingsOverride->getSetting('public.app.appName')); + $this->assertNull($clientSettingsOverride->getSetting('public.app.settings.theme')); + $this->assertEquals('en', $clientSettingsOverride->getSetting('public.app.settings.language')); + $this->assertEquals('wss://test.example.com', $clientSettingsOverride->getSetting('public.kurento.wsUrl')); + + // Remove entire section + $clientSettingsOverride->removeSetting('public.kurento'); + + $this->assertNull($clientSettingsOverride->getSetting('public.kurento.wsUrl')); + $this->assertNull($clientSettingsOverride->getSetting('public.kurento')); + } +} diff --git a/tests/Core/DocumentUrlTest.php b/tests/Core/DocumentUrlTest.php new file mode 100644 index 00000000..a0d2930c --- /dev/null +++ b/tests/Core/DocumentUrlTest.php @@ -0,0 +1,165 @@ +. + */ + +namespace BigBlueButton\Core; + +use BigBlueButton\TestCase; + +/** + * Class DocumentUrlTest. + * + * @internal + */ +class DocumentUrlTest extends TestCase +{ + public function testDocumentUrlConstructor(): void + { + $url = 'https://example.com/document.pdf'; + $name = 'Test Document'; + + $documentUrl = new DocumentUrl($url, $name); + + $this->assertEquals($url, $documentUrl->getUrl()); + $this->assertEquals($name, $documentUrl->getName()); + } + + public function testDocumentUrlConstructorWithoutName(): void + { + $url = 'https://example.com/document.pdf'; + + $documentUrl = new DocumentUrl($url); + + $this->assertEquals($url, $documentUrl->getUrl()); + $this->assertNull($documentUrl->getName()); + } + + public function testSetUrl(): void + { + $documentUrl = new DocumentUrl('https://example.com/old.pdf'); + $newUrl = 'https://example.com/new.pdf'; + + $result = $documentUrl->setUrl($newUrl); + + $this->assertEquals($newUrl, $documentUrl->getUrl()); + $this->assertSame($documentUrl, $result); // Test fluent interface + } + + public function testSetAndGetTimeout(): void + { + $documentUrl = new DocumentUrl('https://example.com/document.pdf'); + + // Test default timeout + $this->assertEquals(5, $documentUrl->getTimeout()); + + // Test setting custom timeout + $timeout = 10; + $result = $documentUrl->setTimeout($timeout); + + $this->assertEquals($timeout, $documentUrl->getTimeout()); + $this->assertSame($documentUrl, $result); // Test fluent interface + } + + public function testIsValidWithValidUrl(): void + { + // Use a reliable URL that should be accessible + $documentUrl = new DocumentUrl('https://httpbin.org/status/200'); + + // This test might be slow due to network call + $isValid = $documentUrl->isValid(); + + $this->assertTrue($isValid); + } + + public function testIsValidWithInvalidUrl(): void + { + // Use a URL that should return 404 + $documentUrl = new DocumentUrl('https://httpbin.org/status/404'); + + // This test might be slow due to network call + $isValid = $documentUrl->isValid(); + + $this->assertFalse($isValid); + } + + public function testIsValidWithNonExistentUrl(): void + { + // Use a non-existent domain + $documentUrl = new DocumentUrl('https://nonexistent-domain-for-testing-12345.com/document.pdf'); + + // This test might be slow due to network timeout + $isValid = $documentUrl->isValid(); + + $this->assertFalse($isValid); + } + + public function testIsValidWithMalformedUrl(): void + { + // Use a malformed URL + $documentUrl = new DocumentUrl('not-a-valid-url'); + + // This should handle the malformed URL gracefully + $isValid = $documentUrl->isValid(); + + $this->assertFalse($isValid); + } + + public function testDocumentUrlInheritance(): void + { + $documentUrl = new DocumentUrl('https://example.com/document.pdf', 'Test'); + + // Test that it inherits from Document + $this->assertInstanceOf(Document::class, $documentUrl); + + // Test inherited methods work + $this->assertEquals('Test', $documentUrl->getName()); + $documentUrl->setName('New Name'); + $this->assertEquals('New Name', $documentUrl->getName()); + } + + public function testSetTimeoutWithZero(): void + { + $documentUrl = new DocumentUrl('https://example.com/document.pdf'); + + $documentUrl->setTimeout(0); + + $this->assertEquals(0, $documentUrl->getTimeout()); + } + + public function testSetTimeoutWithNegativeValue(): void + { + $documentUrl = new DocumentUrl('https://example.com/document.pdf'); + + // Negative timeout should still be set (curl will handle it) + $documentUrl->setTimeout(-5); + + $this->assertEquals(-5, $documentUrl->getTimeout()); + } + + public function testUrlExistsWithNetworkError(): void + { + // Test private method indirectly through isValid() + $documentUrl = new DocumentUrl('https://invalid-domain-that-does-not-exist-12345.com/test.pdf'); + + // This should return false due to network error + $isValid = $documentUrl->isValid(); + + $this->assertFalse($isValid); + } +} diff --git a/tests/Parameters/Config/DocumentOptionsTest.php b/tests/Parameters/Config/DocumentOptionsTest.php new file mode 100644 index 00000000..050a6895 --- /dev/null +++ b/tests/Parameters/Config/DocumentOptionsTest.php @@ -0,0 +1,61 @@ +. + */ + +namespace BigBlueButton\Parameters\Config; + +use BigBlueButton\Enum\DocumentOption; +use BigBlueButton\TestCase; + +/** + * @internal + */ +class DocumentOptionsTest extends TestCase +{ + public function testAddOption(): void + { + $documentOptions = new DocumentOptions(); + $documentOptions + ->addOption(DocumentOption::DOWNLOADABLE, false) + ->addOption(DocumentOption::REMOVABLE, true) + ->addOption(DocumentOption::CURRENT, true) + ; + + self::assertInstanceOf(DocumentOptions::class, $documentOptions); + } + + public function testOptions(): void + { + $documentOptions = new DocumentOptions(); + $documentOptions + ->addOption(DocumentOption::DOWNLOADABLE, false) + ->addOption(DocumentOption::REMOVABLE, true) + ->addOption(DocumentOption::CURRENT, true) + ; + + $optionsToBe = [ + 'downloadable' => false, + 'removable' => true, + 'current' => true, + ]; + + self::assertIsArray($documentOptions->getOptions()); + self::assertEquals($optionsToBe, $documentOptions->getOptions()); + } +} diff --git a/tests/Parameters/CreateMeetingParametersTest.php b/tests/Parameters/CreateMeetingParametersTest.php index b58566b6..b26a503f 100644 --- a/tests/Parameters/CreateMeetingParametersTest.php +++ b/tests/Parameters/CreateMeetingParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,7 +20,7 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; +use BigBlueButton\Core\ClientSettingsOverride; use BigBlueButton\TestServices\Fixtures; /** @@ -28,7 +28,7 @@ * * @internal */ -class CreateMeetingParametersTest extends TestCase +class CreateMeetingParametersTest extends ParameterTestCase { public function testCreateMeetingParameters(): void { @@ -59,7 +59,8 @@ public function testCreateMeetingParameters(): void $this->assertEquals($params['lockSettingsDisableMic'], $createMeetingParams->isLockSettingsDisableMic()); $this->assertEquals($params['lockSettingsDisablePrivateChat'], $createMeetingParams->isLockSettingsDisablePrivateChat()); $this->assertEquals($params['lockSettingsDisablePublicChat'], $createMeetingParams->isLockSettingsDisablePublicChat()); - $this->assertEquals($params['lockSettingsDisableNote'], $createMeetingParams->isLockSettingsDisableNote()); + $this->assertEquals($params['lockSettingsDisableNotes'], $createMeetingParams->isLockSettingsDisableNote()); + $this->assertEquals($params['lockSettingsDisableNotes'], $createMeetingParams->isLockSettingsDisableNotes()); $this->assertEquals($params['lockSettingsHideUserList'], $createMeetingParams->isLockSettingsHideUserList()); $this->assertEquals($params['lockSettingsLockedLayout'], $createMeetingParams->isLockSettingsLockedLayout()); $this->assertEquals($params['lockSettingsLockOnJoin'], $createMeetingParams->isLockSettingsLockOnJoin()); @@ -132,21 +133,216 @@ public function testCreateBreakoutMeeting(): void public function testGetPresentationsAsXMLWithUrl(): void { $createMeetingParams = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); - $createMeetingParams->addPresentation('http://test-install.blindsidenetworks.com/default.pdf'); - $this->assertXmlStringEqualsXmlFile(__DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'presentation_with_url.xml', $createMeetingParams->getPresentationsAsXML()); + $createMeetingParams->addPresentation('https://freetestdata.com/wp-content/uploads/2021/09/Free_Test_Data_100KB_PDF.pdf'); + $this->assertXmlStringEqualsXmlFile(Fixtures::REQUEST_PATH . 'presentation_with_url.xml', $createMeetingParams->getPresentationsAsXML()); } public function testGetPresentationsAsXMLWithUrlAndFilename(): void { $createMeetingParams = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); - $createMeetingParams->addPresentation('http://test-install.blindsidenetworks.com/default.pdf', null, 'presentation.pdf'); - $this->assertXmlStringEqualsXmlFile(__DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'presentation_with_filename.xml', $createMeetingParams->getPresentationsAsXML()); + $createMeetingParams->addPresentation( + 'https://freetestdata.com/wp-content/uploads/2021/09/Free_Test_Data_100KB_PDF.pdf', + null, + 'presentation.pdf' + ); + + $this->assertXmlStringEqualsXmlFile(Fixtures::REQUEST_PATH . 'presentation_with_filename.xml', $createMeetingParams->getPresentationsAsXML()); } + /** + * @throws \Exception + */ public function testGetPresentationsAsXMLWithFile(): void { + $content = file_get_contents(Fixtures::IMAGE_PATH . 'bbb_logo.png'); + $this->assertIsString($content); + $createMeetingParams = Fixtures::getCreateMeetingParametersMock(Fixtures::generateCreateParams()); - $createMeetingParams->addPresentation('bbb_logo.png', file_get_contents(__DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'bbb_logo.png')); - $this->assertXmlStringEqualsXmlFile(__DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'presentation_with_embedded_file.xml', $createMeetingParams->getPresentationsAsXML()); + $createMeetingParams->addPresentation( + 'bbb_logo.png', + $content + ); + + $this->assertXmlStringEqualsXmlFile(Fixtures::REQUEST_PATH . 'presentation_with_file.xml', $createMeetingParams->getPresentationsAsXML()); + } + + public function testClientSettingsOverride(): void + { + $params = Fixtures::generateCreateParams(); + $createMeetingParams = Fixtures::getCreateMeetingParametersMock($params); + + // Test allowOverrideClientSettingsOnCreateCall parameter + $createMeetingParams->setAllowOverrideClientSettingsOnCreateCall(true); + $this->assertTrue($createMeetingParams->isAllowOverrideClientSettingsOnCreateCall()); + + $createMeetingParams->setAllowOverrideClientSettingsOnCreateCall(false); + $this->assertFalse($createMeetingParams->isAllowOverrideClientSettingsOnCreateCall()); + } + + public function testClientSettingsOverrideModule(): void + { + $params = Fixtures::generateCreateParams(); + $createMeetingParams = Fixtures::getCreateMeetingParametersMock($params); + + // Test client settings override module + $settings = [ + 'public' => [ + 'kurento' => [ + 'wsUrl' => 'wss://test.bigbluebutton.org/bbb-webrtc-sfu', + ], + 'media' => [ + 'sipjsHackViaWs' => false, + ], + 'app' => [ + 'appName' => 'Test', + 'helpLink' => 'https://www.bigbluebutton.org', + 'autoJoin' => false, + 'askForConfirmationOnLeave' => false, + 'userSettingsStorage' => 'localStorage', + 'defaultSettings' => [ + 'application' => [ + 'overrideLocale' => 'en', + ], + ], + ], + ], + ]; + + $clientSettingsOverride = new ClientSettingsOverride($settings); + $createMeetingParams->setClientSettingsOverride($clientSettingsOverride); + + $this->assertSame($clientSettingsOverride, $createMeetingParams->getClientSettingsOverride()); + $this->assertEquals($settings, $createMeetingParams->getClientSettingsOverride()->getSettings()); + } + + public function testClientSettingsOverrideXML(): void + { + $params = Fixtures::generateCreateParams(); + $createMeetingParams = Fixtures::getCreateMeetingParametersMock($params); + + $settings = [ + 'public' => [ + 'kurento' => [ + 'wsUrl' => 'wss://test.bigbluebutton.org/bbb-webrtc-sfu', + ], + 'app' => [ + 'appName' => 'Test', + ], + ], + ]; + + $clientSettingsOverride = new ClientSettingsOverride($settings); + $createMeetingParams->setClientSettingsOverride($clientSettingsOverride); + + $xml = $createMeetingParams->getClientSettingsOverrideAsXML(); + + $this->assertNotEmpty($xml); + $this->assertStringContainsString('', $xml); + $this->assertStringContainsString('', $xml); + $this->assertStringContainsString('assertStringContainsString('wss://test.bigbluebutton.org/bbb-webrtc-sfu', $xml); + $this->assertStringContainsString('Test', $xml); + } + + public function testClientSettingsOverrideEmpty(): void + { + $params = Fixtures::generateCreateParams(); + $createMeetingParams = Fixtures::getCreateMeetingParametersMock($params); + + // Test with null client settings override + $this->assertEmpty($createMeetingParams->getClientSettingsOverrideAsXML()); + $this->assertEmpty($createMeetingParams->getModulesAsXML()); + + // Test with empty client settings override + $emptyClientSettingsOverride = new ClientSettingsOverride([]); + $createMeetingParams->setClientSettingsOverride($emptyClientSettingsOverride); + + $this->assertEmpty($createMeetingParams->getClientSettingsOverrideAsXML()); + $this->assertEmpty($createMeetingParams->getModulesAsXML()); + } + + public function testModulesAsXMLWithBothPresentationsAndClientSettings(): void + { + $params = Fixtures::generateCreateParams(); + $createMeetingParams = Fixtures::getCreateMeetingParametersMock($params); + + // Add a presentation + $createMeetingParams->addPresentation('https://example.com/presentation.pdf', null, 'presentation.pdf'); + + // Add client settings override + $settings = [ + 'public' => [ + 'app' => [ + 'appName' => 'Test Meeting', + ], + ], + ]; + $clientSettingsOverride = new ClientSettingsOverride($settings); + $createMeetingParams->setClientSettingsOverride($clientSettingsOverride); + + $modulesXml = $createMeetingParams->getModulesAsXML(); + + $this->assertNotEmpty($modulesXml); + $this->assertStringContainsString('', $modulesXml); + $this->assertStringContainsString('', $modulesXml); + $this->assertStringContainsString('', $modulesXml); + $this->assertStringContainsString('presentation.pdf', $modulesXml); + $this->assertStringContainsString('Test Meeting', $modulesXml); + } + + public function testClientSettingsOverrideFromJson(): void + { + $settings = [ + 'public' => [ + 'app' => [ + 'appName' => 'Test', + ], + ], + ]; + + $json = json_encode($settings); + $clientSettingsOverride = ClientSettingsOverride::fromJson($json); + + $this->assertEquals($settings, $clientSettingsOverride->getSettings()); + } + + public function testClientSettingsOverrideFromInvalidJson(): void + { + $this->expectException(\InvalidArgumentException::class); + $this->expectExceptionMessage('Invalid JSON string'); + + ClientSettingsOverride::fromJson('invalid json'); + } + + public function testClientSettingsOverrideSetAndGetSetting(): void + { + $clientSettingsOverride = new ClientSettingsOverride(); + + // Test setting nested values + $clientSettingsOverride->setSetting('public.app.appName', 'Test App'); + $clientSettingsOverride->setSetting('public.kurento.wsUrl', 'wss://test.example.com'); + + $this->assertEquals('Test App', $clientSettingsOverride->getSetting('public.app.appName')); + $this->assertEquals('wss://test.example.com', $clientSettingsOverride->getSetting('public.kurento.wsUrl')); + $this->assertNull($clientSettingsOverride->getSetting('non.existent.key')); + $this->assertEquals('default', $clientSettingsOverride->getSetting('non.existent.key', 'default')); + } + + public function testClientSettingsOverrideRemoveSetting(): void + { + $settings = [ + 'public' => [ + 'app' => [ + 'appName' => 'Test App', + ], + ], + ]; + + $clientSettingsOverride = new ClientSettingsOverride($settings); + + $this->assertEquals('Test App', $clientSettingsOverride->getSetting('public.app.appName')); + + $clientSettingsOverride->removeSetting('public.app.appName'); + $this->assertNull($clientSettingsOverride->getSetting('public.app.appName')); } } diff --git a/tests/Parameters/DeleteRecordingsParametersTest.php b/tests/Parameters/DeleteRecordingsParametersTest.php index 0e5a5193..bef147b0 100644 --- a/tests/Parameters/DeleteRecordingsParametersTest.php +++ b/tests/Parameters/DeleteRecordingsParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,10 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; - /** * @internal */ -class DeleteRecordingsParametersTest extends TestCase +class DeleteRecordingsParametersTest extends ParameterTestCase { public function testDeleteRecordingParameter(): void { diff --git a/tests/Parameters/EndMeetingParametersTest.php b/tests/Parameters/EndMeetingParametersTest.php index 12536b63..5dd63368 100644 --- a/tests/Parameters/EndMeetingParametersTest.php +++ b/tests/Parameters/EndMeetingParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,10 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; - /** * @internal */ -class EndMeetingParametersTest extends TestCase +class EndMeetingParametersTest extends ParameterTestCase { public function testEndMeetingParameters(): void { diff --git a/tests/Parameters/FeedbackParametersTest.php b/tests/Parameters/FeedbackParametersTest.php new file mode 100644 index 00000000..d57f093b --- /dev/null +++ b/tests/Parameters/FeedbackParametersTest.php @@ -0,0 +1,219 @@ +. + */ + +namespace BigBlueButton\Parameters; + +/** + * Class FeedbackParametersTest. + * + * @internal + */ +class FeedbackParametersTest extends ParameterTestCase +{ + public function testFeedbackParameters(): void + { + $sessionToken = 'test-session-token-123'; + $feedbackParams = new FeedbackParameters($sessionToken); + + $this->assertEquals($sessionToken, $feedbackParams->getSessionToken()); + } + + public function testSetSessionToken(): void + { + $feedbackParams = new FeedbackParameters('original-token'); + + $newToken = 'new-session-token-456'; + $feedbackParams->setSessionToken($newToken); + + $this->assertEquals($newToken, $feedbackParams->getSessionToken()); + } + + public function testRating(): void + { + $feedbackParams = new FeedbackParameters('test-token'); + + // Test default value + $this->assertNull($feedbackParams->getRating()); + + // Test setting rating + $feedbackParams->setRating(5); + $this->assertEquals(5, $feedbackParams->getRating()); + + // Test setting to null + $feedbackParams->setRating(null); + $this->assertNull($feedbackParams->getRating()); + } + + public function testComment(): void + { + $feedbackParams = new FeedbackParameters('test-token'); + + // Test default value + $this->assertNull($feedbackParams->getComment()); + + // Test setting comment + $comment = 'Great meeting experience!'; + $feedbackParams->setComment($comment); + + $this->assertEquals($comment, $feedbackParams->getComment()); + + // Test setting to null + $feedbackParams->setComment(null); + $this->assertNull($feedbackParams->getComment()); + } + + public function testMeetingID(): void + { + $feedbackParams = new FeedbackParameters('test-token'); + + // Test default value + $this->assertNull($feedbackParams->getMeetingID()); + + // Test setting meeting ID + $meetingId = 'meeting123456'; + $feedbackParams->setMeetingID($meetingId); + + $this->assertEquals($meetingId, $feedbackParams->getMeetingID()); + + // Test setting to null + $feedbackParams->setMeetingID(null); + $this->assertNull($feedbackParams->getMeetingID()); + } + + public function testUserID(): void + { + $feedbackParams = new FeedbackParameters('test-token'); + + // Test default value + $this->assertNull($feedbackParams->getUserID()); + + // Test setting user ID + $userId = 'user789'; + $feedbackParams->setUserID($userId); + + $this->assertEquals($userId, $feedbackParams->getUserID()); + + // Test setting to null + $feedbackParams->setUserID(null); + $this->assertNull($feedbackParams->getUserID()); + } + + public function testGetHTTPQuery(): void + { + $feedbackParams = new FeedbackParameters('test-session-token'); + + // Add some parameters + $feedbackParams->setRating(4); + $feedbackParams->setComment('Good meeting overall'); + $feedbackParams->setMeetingID('meeting123'); + $feedbackParams->setUserID('user456'); + + $query = $feedbackParams->getHTTPQuery(); + + $this->assertStringContainsString('sessionToken=test-session-token', $query); + $this->assertStringContainsString('rating=4', $query); + $this->assertStringContainsString('comment=Good+meeting+overall', $query); + $this->assertStringContainsString('meetingID=meeting123', $query); + $this->assertStringContainsString('userID=user456', $query); + } + + public function testGetHTTPQueryWithMinimalParameters(): void + { + $feedbackParams = new FeedbackParameters('minimal-token'); + $query = $feedbackParams->getHTTPQuery(); + + $this->assertStringContainsString('sessionToken=minimal-token', $query); + $this->assertStringNotContainsString('rating', $query); + $this->assertStringNotContainsString('comment', $query); + $this->assertStringNotContainsString('meetingID', $query); + $this->assertStringNotContainsString('userID', $query); + } + + public function testFluentInterface(): void + { + $feedbackParams = new FeedbackParameters('test-token'); + + $result = $feedbackParams + ->setSessionToken('new-token') + ->setRating(5) + ->setComment('Excellent meeting!') + ->setMeetingID('meeting789') + ->setUserID('user123') + ; + + $this->assertSame($feedbackParams, $result); + $this->assertEquals('new-token', $feedbackParams->getSessionToken()); + $this->assertEquals(5, $feedbackParams->getRating()); + $this->assertEquals('Excellent meeting!', $feedbackParams->getComment()); + $this->assertEquals('meeting789', $feedbackParams->getMeetingID()); + $this->assertEquals('user123', $feedbackParams->getUserID()); + } + + public function testRatingValidation(): void + { + $feedbackParams = new FeedbackParameters('test-token'); + + // Test valid ratings + $validRatings = [1, 2, 3, 4, 5]; + foreach ($validRatings as $rating) { + $feedbackParams->setRating($rating); + $this->assertEquals($rating, $feedbackParams->getRating()); + } + + // Test zero rating (might be valid depending on implementation) + $feedbackParams->setRating(0); + $this->assertEquals(0, $feedbackParams->getRating()); + } + + public function testCommentWithSpecialCharacters(): void + { + $feedbackParams = new FeedbackParameters('test-token'); + + $comment = 'Great meeting! Loved the features. ๐Ÿ‘'; + $feedbackParams->setComment($comment); + + $query = $feedbackParams->getHTTPQuery(); + + // The comment should be URL-encoded + $this->assertStringContainsString('comment=Great+meeting%21+Loved+the+features.+%F0%9F%91%8D', $query); + $this->assertEquals($comment, $feedbackParams->getComment()); + } + + public function testComplexFeedbackScenario(): void + { + $feedbackParams = new FeedbackParameters('complex-session-token'); + + // Simulate a real feedback submission + $feedbackParams + ->setRating(4) + ->setComment('The meeting was good overall, but the audio quality could be improved.') + ->setMeetingID('weekly-team-meeting-001') + ->setUserID('participant-john-doe') + ; + + $query = $feedbackParams->getHTTPQuery(); + + $this->assertStringContainsString('sessionToken=complex-session-token', $query); + $this->assertStringContainsString('rating=4', $query); + $this->assertStringContainsString('comment=The+meeting+was+good+overall', $query); + $this->assertStringContainsString('meetingID=weekly-team-meeting-001', $query); + $this->assertStringContainsString('userID=participant-john-doe', $query); + } +} diff --git a/tests/Parameters/GetJoinUrlParametersTest.php b/tests/Parameters/GetJoinUrlParametersTest.php new file mode 100644 index 00000000..14a23d22 --- /dev/null +++ b/tests/Parameters/GetJoinUrlParametersTest.php @@ -0,0 +1,183 @@ +. + */ + +namespace BigBlueButton\Parameters; + +use BigBlueButton\Enum\MeetingLayout; + +/** + * Class GetJoinUrlParametersTest. + * + * @internal + */ +class GetJoinUrlParametersTest extends ParameterTestCase +{ + public function testGetJoinUrlParameters(): void + { + $sessionToken = 'test-session-token-123'; + $getJoinUrlParams = new GetJoinUrlParameters($sessionToken); + + $this->assertEquals($sessionToken, $getJoinUrlParams->getSessionToken()); + } + + public function testSetSessionToken(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('original-token'); + + $newToken = 'new-session-token-456'; + $getJoinUrlParams->setSessionToken($newToken); + + $this->assertEquals($newToken, $getJoinUrlParams->getSessionToken()); + } + + public function testReplaceSession(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('test-token'); + + // Test default value + $this->assertNull($getJoinUrlParams->isReplaceSession()); + + // Test setting to true + $getJoinUrlParams->setReplaceSession(true); + $this->assertTrue($getJoinUrlParams->isReplaceSession()); + + // Test setting to false + $getJoinUrlParams->setReplaceSession(false); + $this->assertFalse($getJoinUrlParams->isReplaceSession()); + } + + public function testSessionName(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('test-token'); + + // Test default value + $this->assertNull($getJoinUrlParams->getSessionName()); + + // Test setting session name + $sessionName = 'Mobile Device Session'; + $getJoinUrlParams->setSessionName($sessionName); + + $this->assertEquals($sessionName, $getJoinUrlParams->getSessionName()); + + // Test setting to null + $getJoinUrlParams->setSessionName(null); + $this->assertNull($getJoinUrlParams->getSessionName()); + } + + public function testEnforceLayout(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('test-token'); + + // Test default value + $this->assertNull($getJoinUrlParams->getEnforceLayout()); + + // Test setting layout + $layout = MeetingLayout::VIDEO_FOCUS; + $getJoinUrlParams->setEnforceLayout($layout); + + $this->assertSame($layout, $getJoinUrlParams->getEnforceLayout()); + + // Test setting to null + $getJoinUrlParams->setEnforceLayout(null); + $this->assertNull($getJoinUrlParams->getEnforceLayout()); + } + + public function testUserDataParameters(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('test-token'); + + // Test adding userdata parameters + $getJoinUrlParams->addMeta('userdata-custom-field', 'custom-value'); + $getJoinUrlParams->addMeta('userdata-device-type', 'mobile'); + + $this->assertEquals('custom-value', $getJoinUrlParams->getMeta('userdata-custom-field')); + $this->assertEquals('mobile', $getJoinUrlParams->getMeta('userdata-device-type')); + } + + public function testGetHTTPQuery(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('test-session-token'); + + // Add some parameters + $getJoinUrlParams->setReplaceSession(true); + $getJoinUrlParams->setSessionName('Test Session'); + $getJoinUrlParams->setEnforceLayout(MeetingLayout::PRESENTATION_FOCUS); + $getJoinUrlParams->addMeta('userdata-device', 'tablet'); + + $query = $getJoinUrlParams->getHTTPQuery(); + + $this->assertStringContainsString('sessionToken=test-session-token', $query); + $this->assertStringContainsString('replaceSession=true', $query); + $this->assertStringContainsString('sessionName=Test+Session', $query); + $this->assertStringContainsString('enforceLayout=PRESENTATION_FOCUS', $query); + $this->assertStringContainsString('userdata-device=tablet', $query); + } + + public function testGetHTTPQueryWithMinimalParameters(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('minimal-token'); + $query = $getJoinUrlParams->getHTTPQuery(); + + $this->assertStringContainsString('sessionToken=minimal-token', $query); + $this->assertStringNotContainsString('replaceSession', $query); + $this->assertStringNotContainsString('sessionName', $query); + $this->assertStringNotContainsString('enforceLayout', $query); + } + + public function testFluentInterface(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('test-token'); + + $result = $getJoinUrlParams + ->setSessionToken('new-token') + ->setReplaceSession(true) + ->setSessionName('Fluent Session') + ->setEnforceLayout(MeetingLayout::SMART_LAYOUT) + ->addMeta('userdata-test', 'value') + ; + + $this->assertSame($getJoinUrlParams, $result); + $this->assertEquals('new-token', $getJoinUrlParams->getSessionToken()); + $this->assertTrue($getJoinUrlParams->isReplaceSession()); + $this->assertEquals('Fluent Session', $getJoinUrlParams->getSessionName()); + $this->assertSame(MeetingLayout::SMART_LAYOUT, $getJoinUrlParams->getEnforceLayout()); + $this->assertEquals('value', $getJoinUrlParams->getMeta('userdata-test')); + } + + public function testComplexUserdataParameters(): void + { + $getJoinUrlParams = new GetJoinUrlParameters('complex-token'); + + // Add multiple userdata parameters + $getJoinUrlParams->addMeta('userdata-user-id', 'user123'); + $getJoinUrlParams->addMeta('userdata-preference-theme', 'dark'); + $getJoinUrlParams->addMeta('userdata-device-info', json_encode([ + 'type' => 'mobile', + 'os' => 'iOS', + 'version' => '15.0', + ])); + + $query = $getJoinUrlParams->getHTTPQuery(); + + $this->assertStringContainsString('userdata-user-id=user123', $query); + $this->assertStringContainsString('userdata-preference-theme=dark', $query); + $this->assertStringContainsString('userdata-device-info=', $query); + } +} diff --git a/tests/Parameters/GetMeetingInfoParametersTest.php b/tests/Parameters/GetMeetingInfoParametersTest.php index 81198c7e..b606ab2c 100644 --- a/tests/Parameters/GetMeetingInfoParametersTest.php +++ b/tests/Parameters/GetMeetingInfoParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,10 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; - /** * @internal */ -class GetMeetingInfoParametersTest extends TestCase +class GetMeetingInfoParametersTest extends ParameterTestCase { public function testGetMeetingInfoParameters(): void { diff --git a/tests/Parameters/GetRecordingTextTracksParametersTest.php b/tests/Parameters/GetRecordingTextTracksParametersTest.php index 0ba0231a..df06270c 100644 --- a/tests/Parameters/GetRecordingTextTracksParametersTest.php +++ b/tests/Parameters/GetRecordingTextTracksParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,10 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; - /** * @internal */ -class GetRecordingTextTracksParametersTest extends TestCase +class GetRecordingTextTracksParametersTest extends ParameterTestCase { public function testGetRecordingTextTracksParameters(): void { diff --git a/tests/Parameters/GetRecordingsParametersTest.php b/tests/Parameters/GetRecordingsParametersTest.php index c465f497..e34fe233 100644 --- a/tests/Parameters/GetRecordingsParametersTest.php +++ b/tests/Parameters/GetRecordingsParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,10 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; - /** * @internal */ -class GetRecordingsParametersTest extends TestCase +class GetRecordingsParametersTest extends ParameterTestCase { public function testGetRecordingsParameters(): void { diff --git a/tests/Parameters/HooksCreateParametersTest.php b/tests/Parameters/HooksCreateParametersTest.php index a2b2b1c0..449c5f50 100644 --- a/tests/Parameters/HooksCreateParametersTest.php +++ b/tests/Parameters/HooksCreateParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,30 +20,52 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; +use BigBlueButton\Enum\WebHookEvent; +use BigBlueButton\TestServices\Fixtures; /** * @internal */ -class HooksCreateParametersTest extends TestCase +class HooksCreateParametersTest extends ParameterTestCase { public function testHooksCreateParameters(): void { - // create string of eventIds + $hooksCreateParameters = new HooksCreateParameters($callBackUrl = $this->faker->url); + + // Get raw values from fixtures and ensure we have an array + $rawEvents = (array) Fixtures::randomEnumValues($this->faker, WebHookEvent::class, null, 'array'); + + // Convert to WebHookEvent instances with proper type handling $eventIds = []; - for ($i = 0; $i < $this->faker->numberBetween(1, 5); ++$i) { - $eventIds[] = $this->faker->uuid; - } - $eventIds = implode(',', $eventIds); + foreach ($rawEvents as $event) { + if ($event instanceof WebHookEvent) { + $eventIds[] = $event; - $hooksCreateParameters = new HooksCreateParameters($callBackUrl = $this->faker->url); + continue; + } + + if (is_string($event)) { + $eventIds[] = WebHookEvent::from($event); + + continue; + } + + if (is_object($event) && method_exists($event, '__toString')) { + $eventIds[] = WebHookEvent::from((string) $event); + + continue; + } + + throw new \InvalidArgumentException('Invalid event type provided'); + } $this->assertEquals($callBackUrl, $hooksCreateParameters->getCallbackUrl()); - // Test setters that are ignored by the constructor + // Test setters $hooksCreateParameters->setMeetingId($meetingId = $this->faker->uuid); $hooksCreateParameters->setGetRaw($getRaw = $this->faker->boolean); $hooksCreateParameters->setEventId($eventIds); + $this->assertEquals($meetingId, $hooksCreateParameters->getMeetingId()); $this->assertEquals($getRaw, $hooksCreateParameters->getRaw()); $this->assertEquals($eventIds, $hooksCreateParameters->getEventId()); diff --git a/tests/Parameters/HooksDestroyParametersTest.php b/tests/Parameters/HooksDestroyParametersTest.php index bba38c0a..f0618c44 100644 --- a/tests/Parameters/HooksDestroyParametersTest.php +++ b/tests/Parameters/HooksDestroyParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,10 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; - /** * @internal */ -class HooksDestroyParametersTest extends TestCase +class HooksDestroyParametersTest extends ParameterTestCase { public function testHooksDestroyParameters(): void { @@ -35,4 +33,78 @@ public function testHooksDestroyParameters(): void $this->assertEquals($hookId, $hooksDestroyParameters->getHookId()); } + + public function testSetHookId(): void + { + $originalHookId = 'original-hook-123'; + $newHookId = 'new-hook-456'; + + $hooksDestroyParameters = new HooksDestroyParameters($originalHookId); + + // Test initial value + $this->assertEquals($originalHookId, $hooksDestroyParameters->getHookId()); + + // Test setting new value + $result = $hooksDestroyParameters->setHookId($newHookId); + + $this->assertEquals($newHookId, $hooksDestroyParameters->getHookId()); + $this->assertSame($hooksDestroyParameters, $result); // Test fluent interface + } + + public function testHooksDestroyParametersWithEmptyHookId(): void + { + $hooksDestroyParameters = new HooksDestroyParameters(''); + + $this->assertEquals('', $hooksDestroyParameters->getHookId()); + } + + public function testHooksDestroyParametersWithLongHookId(): void + { + $longHookId = str_repeat('a', 100); + $hooksDestroyParameters = new HooksDestroyParameters($longHookId); + + $this->assertEquals($longHookId, $hooksDestroyParameters->getHookId()); + } + + public function testHooksDestroyParametersWithSpecialCharacters(): void + { + $specialHookId = 'hook-123_abc.xyz'; + $hooksDestroyParameters = new HooksDestroyParameters($specialHookId); + + $this->assertEquals($specialHookId, $hooksDestroyParameters->getHookId()); + } + + public function testHooksDestroyParametersFluentInterface(): void + { + $hooksDestroyParameters = new HooksDestroyParameters('initial-hook'); + + $result = $hooksDestroyParameters + ->setHookId('updated-hook-1') + ->setHookId('updated-hook-2') + ; + + $this->assertSame($hooksDestroyParameters, $result); + $this->assertEquals('updated-hook-2', $hooksDestroyParameters->getHookId()); + } + + public function testHooksDestroyParametersToApiDataArray(): void + { + $hookId = 'test-hook-789'; + $hooksDestroyParameters = new HooksDestroyParameters($hookId); + + $apiData = $hooksDestroyParameters->toApiDataArray(); + + $this->assertIsArray($apiData); + $this->assertEquals($hookId, $apiData['hookID']); + } + + public function testHooksDestroyParametersGetHTTPQuery(): void + { + $hookId = 'test-hook-456'; + $hooksDestroyParameters = new HooksDestroyParameters($hookId); + + $query = $hooksDestroyParameters->getHTTPQuery(); + + $this->assertStringContainsString("hookID={$hookId}", $query); + } } diff --git a/tests/Parameters/InsertDocumentParametersTest.php b/tests/Parameters/InsertDocumentParametersTest.php index d15e3cca..821484a1 100644 --- a/tests/Parameters/InsertDocumentParametersTest.php +++ b/tests/Parameters/InsertDocumentParametersTest.php @@ -5,7 +5,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -22,24 +22,185 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; +use BigBlueButton\Core\DocumentFile; +use BigBlueButton\Core\DocumentUrl; +use BigBlueButton\Enum\DocumentOption; +use BigBlueButton\Parameters\Config\DocumentOptions; +use BigBlueButton\TestServices\Fixtures; /** * @internal */ -final class InsertDocumentParametersTest extends TestCase +final class InsertDocumentParametersTest extends ParameterTestCase { - public function testInsertDocumentParameters(): void + public function testSetMeetingId(): void + { + $originalMeetingId = 'original-meeting-123'; + $newMeetingId = 'new-meeting-456'; + + $insertDocumentParameters = new InsertDocumentParameters($originalMeetingId); + + // Test initial value + $this->assertEquals($originalMeetingId, $insertDocumentParameters->getMeetingId()); + + // Test setting new value + $result = $insertDocumentParameters->setMeetingId($newMeetingId); + + $this->assertEquals($newMeetingId, $insertDocumentParameters->getMeetingId()); + $this->assertSame($insertDocumentParameters, $result); // Test fluent interface + } + + public function testInsertDocumentParametersWithMultiPresentationsWithoutOptions(): void + { + $meetingId = $this->faker->uuid; + $insertDocumentParameters = new InsertDocumentParameters($meetingId); + + $insertDocumentParameters + ->addPresentation('https://freetestdata.com/wp-content/uploads/2021/09/Free_Test_Data_100KB_PDF.pdf') + ->addPresentation('https://freetestdata.com/wp-content/uploads/2022/02/Free_Test_Data_117KB_JPG.jpg') + ->addPresentation('https://freetestdata.com/wp-content/uploads/2021/09/500kb.png') + ->addPresentation('https://freetestdata.com/wp-content/uploads/2021/09/1.svg') + ; + + $this->assertEquals($meetingId, $insertDocumentParameters->getMeetingID()); + + $this->assertXmlStringEqualsXmlFile( + Fixtures::REQUEST_PATH . 'insert_document_presentations.xml', + $insertDocumentParameters->getPresentationsAsXML() + ); + } + + public function testInsertDocumentParametersWithOnePresentationAndWithOptions(): void { $meetingId = $this->faker->uuid; - $params = new InsertDocumentParameters($meetingId); - $params->addPresentation('https://demo.bigbluebutton.org/biglbuebutton.png'); - $params->addPresentation('https://demo.bigbluebutton.org/biglbuebutton.pdf'); - $params->addPresentation('https://demo.bigbluebutton.org/biglbuebutton.svg'); + $documentOptions = new DocumentOptions(); + $documentOptions + ->addOption(DocumentOption::DOWNLOADABLE, false) + ->addOption(DocumentOption::REMOVABLE, true) + ->addOption(DocumentOption::CURRENT, true) + ; + $insertDocumentParameters = new InsertDocumentParameters($meetingId); + + $insertDocumentParameters->addPresentation('https://demo.bigbluebutton.org/bigbluebutton.png', null, null, $documentOptions); + + $this->assertEquals($meetingId, $insertDocumentParameters->getMeetingID()); + + $this->assertXmlStringEqualsXmlFile( + Fixtures::REQUEST_PATH . 'insert_document_presentations_with_options.xml', + $insertDocumentParameters->getPresentationsAsXML() + ); + } + + public function testInsertDocumentParametersWithDocumentUrlMultiWithoutOptions(): void + { + // ARRANGE + $meetingId = $this->faker->uuid; + $filepath = dirname(__DIR__) . \DIRECTORY_SEPARATOR . 'fixtures' . \DIRECTORY_SEPARATOR . 'insert_document_presentations_with_filenames.xml'; + $documentUrl1 = new DocumentUrl('https://demo.bigbluebutton.org/bigbluebutton.png', 'bigbluebutton.png'); + $documentUrl2 = new DocumentUrl('https://demo.bigbluebutton.org/bigbluebutton.pdf', 'bigbluebutton.pdf'); + $documentUrl3 = new DocumentUrl('https://demo.bigbluebutton.org/bigbluebutton.svg', 'bigbluebutton.svg'); + + // ACT + $insertDocumentParameters = new InsertDocumentParameters($meetingId); + $insertDocumentParameters + ->addDocument($documentUrl1) + ->addDocument($documentUrl2) + ->addDocument($documentUrl3) + ; + $xmlAsIs = $insertDocumentParameters->getDocumentsAsXML(); + + // ASSERT + $this->assertEquals($meetingId, $insertDocumentParameters->getMeetingID()); + $this->assertCount(3, $insertDocumentParameters->getDocuments()); + $this->assertIsString($xmlAsIs); + $this->assertXmlStringEqualsXmlFile($filepath, $xmlAsIs); + } + + public function testInsertDocumentParametersWithDocumentUrlOneWithOptions(): void + { + // ARRANGE + $meetingId = $this->faker->uuid; + $filepath = dirname(__DIR__) . \DIRECTORY_SEPARATOR . 'fixtures' . \DIRECTORY_SEPARATOR . 'insert_document_presentations_with_filenames_and_options.xml'; + $documentUrl = new DocumentUrl('https://demo.bigbluebutton.org/bigbluebutton.png', 'bigbluebutton.png'); + $documentUrl->setDownloadable(false)->setRemovable(true)->setCurrent(true); + + // ACT + $insertDocumentParameters = new InsertDocumentParameters($meetingId); + $insertDocumentParameters->addDocument($documentUrl); + $xmlAsIs = $insertDocumentParameters->getDocumentsAsXML(); + + // ASSERT + $this->assertEquals($meetingId, $insertDocumentParameters->getMeetingID()); + $this->assertCount(1, $insertDocumentParameters->getDocuments()); + $this->assertIsString($xmlAsIs); + $this->assertXmlStringEqualsXmlFile($filepath, $xmlAsIs); + } + + public function testInsertDocumentParametersWithDocumentUrlOneWithAdditionalProperties(): void + { + // ARRANGE + $meetingId = $this->faker->uuid; + $filepath = dirname(__DIR__) . \DIRECTORY_SEPARATOR . 'fixtures' . \DIRECTORY_SEPARATOR . 'insert_document_case_3.xml'; + $documentUrl = new DocumentUrl('https://demo.bigbluebutton.org/bigbluebutton.png', 'bigbluebutton.png'); + $documentUrl + ->addProperty('magic1', 'abracadabra') + ->addProperty('magic2', 'hocus-pocus') + ->addProperty('magic3', 'open sesame') + ; + + // ACT + $insertDocumentParameters = new InsertDocumentParameters($meetingId); + $insertDocumentParameters->addDocument($documentUrl); + $xmlAsIs = $insertDocumentParameters->getDocumentsAsXML(); + + // ASSERT + $this->assertEquals($meetingId, $insertDocumentParameters->getMeetingID()); + $this->assertCount(1, $insertDocumentParameters->getDocuments()); + $this->assertIsString($xmlAsIs); + $this->assertXmlStringEqualsXmlFile($filepath, $xmlAsIs); + } + + public function testInsertDocumentParametersWithDocumentFileOneWithoutOptions(): void + { + // ARRANGE + $meetingId = $this->faker->uuid; + $filepath = Fixtures::IMAGE_PATH . 'bbb_logo.png'; + $filename = 'picture.png'; + $filepathXml = dirname(__DIR__) . \DIRECTORY_SEPARATOR . 'fixtures' . \DIRECTORY_SEPARATOR . 'insert_document_case_1.xml'; + $documentUrl = new DocumentFile($filepath, $filename); + + // ACT + $insertDocumentParameters = new InsertDocumentParameters($meetingId); + $insertDocumentParameters->addDocument($documentUrl); + $xmlAsIs = $insertDocumentParameters->getDocumentsAsXML(); + + // ASSERT + $this->assertEquals($meetingId, $insertDocumentParameters->getMeetingID()); + $this->assertCount(1, $insertDocumentParameters->getDocuments()); + $this->assertIsString($xmlAsIs); + $this->assertXmlStringEqualsXmlFile($filepathXml, $xmlAsIs); + } + + public function testInsertDocumentParametersWithDocumentFileOneWithOptions(): void + { + // ARRANGE + $meetingId = $this->faker->uuid; + $filepath = Fixtures::IMAGE_PATH . 'bbb_logo.png'; + $filename = 'picture.png'; + $filepathXml = dirname(__DIR__) . \DIRECTORY_SEPARATOR . 'fixtures' . \DIRECTORY_SEPARATOR . 'insert_document_case_2.xml'; + $documentUrl = new DocumentFile($filepath, $filename); + $documentUrl->setDownloadable(false)->setRemovable(true)->setCurrent(true); - $this->assertEquals($meetingId, $params->getMeetingID()); + // ACT + $insertDocumentParameters = new InsertDocumentParameters($meetingId); + $insertDocumentParameters->addDocument($documentUrl); + $xmlAsIs = $insertDocumentParameters->getDocumentsAsXML(); - $this->assertXmlStringEqualsXmlFile(dirname(__DIR__) . \DIRECTORY_SEPARATOR . 'fixtures' . \DIRECTORY_SEPARATOR . 'insert_document_presentations.xml', $params->getPresentationsAsXML()); + // ASSERT + $this->assertEquals($meetingId, $insertDocumentParameters->getMeetingID()); + $this->assertCount(1, $insertDocumentParameters->getDocuments()); + $this->assertIsString($xmlAsIs); + $this->assertXmlStringEqualsXmlFile($filepathXml, $xmlAsIs); } } diff --git a/tests/Parameters/IsMeetingRunningParametersTest.php b/tests/Parameters/IsMeetingRunningParametersTest.php index 2e661957..30038214 100644 --- a/tests/Parameters/IsMeetingRunningParametersTest.php +++ b/tests/Parameters/IsMeetingRunningParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,14 +20,12 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; - /** * Class IsMeetingRunningParametersTest. * * @internal */ -class IsMeetingRunningParametersTest extends TestCase +class IsMeetingRunningParametersTest extends ParameterTestCase { public function testIsMeetingRunningParameters(): void { diff --git a/tests/Parameters/JoinMeetingParametersTest.php b/tests/Parameters/JoinMeetingParametersTest.php index debd15e8..04e7644b 100644 --- a/tests/Parameters/JoinMeetingParametersTest.php +++ b/tests/Parameters/JoinMeetingParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -22,13 +22,12 @@ use BigBlueButton\Enum\MeetingLayout; use BigBlueButton\Enum\Role; -use BigBlueButton\TestCase; use BigBlueButton\TestServices\Fixtures; /** * @internal */ -class JoinMeetingParametersTest extends TestCase +class JoinMeetingParametersTest extends ParameterTestCase { public function testJoinMeetingParameters(): void { @@ -49,13 +48,15 @@ public function testJoinMeetingParameters(): void // Test setters that are ignored by the constructor $joinMeetingParams->setMeetingId($newId = $this->faker->uuid); $joinMeetingParams->setUsername($newName = $this->faker->name); - $joinMeetingParams->setRole($newRole = $this->faker->randomElement(Role::getValues())); + $joinMeetingParams->setRole($newRole = $this->faker->randomElement(Role::cases())); $joinMeetingParams->setPassword($newPassword = $this->faker->password); $joinMeetingParams->setExcludeFromDashboard($excludeFromDashboard = $this->faker->boolean); $joinMeetingParams->setAvatarURL($avatarUrl = $this->faker->url); $joinMeetingParams->setRedirect($redirect = $this->faker->boolean(50)); $joinMeetingParams->setGuest($guest = $this->faker->boolean(50)); - $joinMeetingParams->setDefaultLayout($defaultLayout = $this->faker->randomElement(MeetingLayout::getValues())); + $joinMeetingParams->setDefaultLayout($defaultLayout = $this->faker->randomElement(MeetingLayout::cases())); + $joinMeetingParams->setErrorRedirectUrl($errorRedirectUrl = $this->faker->url()); + $joinMeetingParams->setWebcamBackgroundURL($webcamBackgroundUrl = $this->faker->url()); $this->assertEquals($newId, $joinMeetingParams->getMeetingId()); $this->assertEquals($newName, $joinMeetingParams->getUsername()); $this->assertEquals($newRole, $joinMeetingParams->getRole()); @@ -65,5 +66,7 @@ public function testJoinMeetingParameters(): void $this->assertEquals($redirect, $joinMeetingParams->isRedirect()); $this->assertEquals($guest, $joinMeetingParams->isGuest()); $this->assertEquals($defaultLayout, $joinMeetingParams->getDefaultLayout()); + $this->assertEquals($errorRedirectUrl, $joinMeetingParams->getErrorRedirectUrl()); + $this->assertEquals($webcamBackgroundUrl, $joinMeetingParams->getWebcamBackgroundURL()); } } diff --git a/tests/Parameters/ParameterTestCase.php b/tests/Parameters/ParameterTestCase.php new file mode 100644 index 00000000..f5c027d6 --- /dev/null +++ b/tests/Parameters/ParameterTestCase.php @@ -0,0 +1,25 @@ +. + */ + +namespace BigBlueButton\Parameters; + +use BigBlueButton\TestCase; + +abstract class ParameterTestCase extends TestCase {} diff --git a/tests/Parameters/PublishRecordingsParametersTest.php b/tests/Parameters/PublishRecordingsParametersTest.php index 1cf5fad4..15d3c11b 100644 --- a/tests/Parameters/PublishRecordingsParametersTest.php +++ b/tests/Parameters/PublishRecordingsParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,12 +20,10 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; - /** * @internal */ -class PublishRecordingsParametersTest extends TestCase +class PublishRecordingsParametersTest extends ParameterTestCase { public function testPublishRecordingsParameters(): void { diff --git a/tests/Parameters/PutRecordingTextTrackParametersTest.php b/tests/Parameters/PutRecordingTextTrackParametersTest.php index cefc8e1e..4d7b23f9 100644 --- a/tests/Parameters/PutRecordingTextTrackParametersTest.php +++ b/tests/Parameters/PutRecordingTextTrackParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Parameters/SendChatMessageParametersTest.php b/tests/Parameters/SendChatMessageParametersTest.php new file mode 100644 index 00000000..a5c48b24 --- /dev/null +++ b/tests/Parameters/SendChatMessageParametersTest.php @@ -0,0 +1,41 @@ +. + */ + +namespace BigBlueButton\Parameters; + +/** + * @internal + */ +class SendChatMessageParametersTest extends ParameterTestCase +{ + public function testEndMeetingParameters(): void + { + $sendChatMessageParams = new SendChatMessageParameters($meetingId = $this->faker->uuid(), $message = $this->faker->sentence()); + + $this->assertEquals($meetingId, $sendChatMessageParams->getMeetingId()); + $this->assertEquals($message, $sendChatMessageParams->getMessage()); + + // Test setters that are ignored by the constructor + $sendChatMessageParams->setMeetingId($newId = $this->faker->uuid); + $sendChatMessageParams->setMessage($newMessage = $this->faker->sentence); + $this->assertEquals($newId, $sendChatMessageParams->getMeetingId()); + $this->assertEquals($newMessage, $sendChatMessageParams->getMessage()); + } +} diff --git a/tests/Parameters/UpdateRecordingsParametersTest.php b/tests/Parameters/UpdateRecordingsParametersTest.php index 4d750695..27eb8e2f 100644 --- a/tests/Parameters/UpdateRecordingsParametersTest.php +++ b/tests/Parameters/UpdateRecordingsParametersTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -20,13 +20,12 @@ namespace BigBlueButton\Parameters; -use BigBlueButton\TestCase; use BigBlueButton\TestServices\Fixtures; /** * @internal */ -class UpdateRecordingsParametersTest extends TestCase +class UpdateRecordingsParametersTest extends ParameterTestCase { public function testUpdateRecordingsParameters(): void { diff --git a/tests/Responses/ApiVersionResponseTest.php b/tests/Responses/ApiVersionResponseTest.php index f7505327..d426cb18 100644 --- a/tests/Responses/ApiVersionResponseTest.php +++ b/tests/Responses/ApiVersionResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -46,7 +46,7 @@ public function testApiVersionResponseContent(): void $this->assertEquals('SUCCESS', $this->apiVersionResponse->getReturnCode()); $this->assertEquals('2.0', $this->apiVersionResponse->getVersion()); $this->assertEquals('2.0', $this->apiVersionResponse->getApiVersion()); - $this->assertEquals('2.4-rc-7', $this->apiVersionResponse->getBbbVersion()); + $this->assertEquals('3.0.19', $this->apiVersionResponse->getBbbVersion()); } public function testApiVersionResponseTypes(): void diff --git a/tests/Responses/BaseJsonResponseTest.php b/tests/Responses/BaseJsonResponseTest.php new file mode 100644 index 00000000..5e2c0287 --- /dev/null +++ b/tests/Responses/BaseJsonResponseTest.php @@ -0,0 +1,232 @@ +. + */ + +namespace BigBlueButton\Responses; + +use BigBlueButton\TestCase; + +/** + * Class BaseJsonResponseTest. + * + * @internal + */ +class BaseJsonResponseTest extends TestCase +{ + public function testBaseJsonResponseSuccess(): void + { + $json = json_encode([ + 'response' => [ + 'returncode' => 'SUCCESS', + 'message' => 'Operation successful', + 'messageKey' => 'successKey', + ], + ]); + + $response = new TestableJsonResponse($json); + + $this->assertTrue($response->success()); + $this->assertFalse($response->failed()); + $this->assertEquals('SUCCESS', $response->getReturnCode()); + // getMessage() only returns value for failed responses + $this->assertNull($response->getMessage()); + $this->assertNull($response->getMessageKey()); + } + + public function testBaseJsonResponseFailed(): void + { + $json = json_encode([ + 'response' => [ + 'returncode' => 'FAILED', + 'message' => 'Operation failed', + 'messageKey' => 'errorKey', + ], + ]); + + $response = new TestableJsonResponse($json); + + $this->assertFalse($response->success()); + $this->assertTrue($response->failed()); + $this->assertEquals('FAILED', $response->getReturnCode()); + $this->assertEquals('Operation failed', $response->getMessage()); + $this->assertEquals('errorKey', $response->getMessageKey()); + } + + public function testBaseJsonResponseSuccessWithoutMessage(): void + { + $json = json_encode([ + 'response' => [ + 'returncode' => 'SUCCESS', + ], + ]); + + $response = new TestableJsonResponse($json); + + $this->assertTrue($response->success()); + $this->assertFalse($response->failed()); + $this->assertEquals('SUCCESS', $response->getReturnCode()); + $this->assertNull($response->getMessage()); + $this->assertNull($response->getMessageKey()); + } + + public function testBaseJsonResponseFailedWithoutMessage(): void + { + $json = json_encode([ + 'response' => [ + 'returncode' => 'FAILED', + ], + ]); + + $response = new TestableJsonResponse($json); + + $this->assertFalse($response->success()); + $this->assertTrue($response->failed()); + $this->assertEquals('FAILED', $response->getReturnCode()); + $this->assertNull($response->getMessage()); + $this->assertNull($response->getMessageKey()); + } + + public function testBaseJsonResponseGetRawJson(): void + { + $originalData = [ + 'response' => [ + 'returncode' => 'SUCCESS', + 'message' => 'Test message', + ], + ]; + $json = json_encode($originalData); + + $response = new TestableJsonResponse($json); + $rawJson = $response->getRawJson(); + + $this->assertEquals($json, $rawJson); + + // Verify the raw JSON can be decoded back to the original data + $decodedData = json_decode($rawJson, true); + $this->assertEquals($originalData, $decodedData); + } + + public function testBaseJsonResponseWithInvalidJson(): void + { + $invalidJson = '{ invalid json }'; + + $this->expectException(\RuntimeException::class); + $this->expectExceptionMessage('Invalid JSON response:'); + + new TestableJsonResponse($invalidJson); + } + + public function testBaseJsonResponseWithMissingResponseField(): void + { + $json = json_encode([ + 'data' => [ + 'returncode' => 'SUCCESS', + ], + ]); + + $this->expectException(\RuntimeException::class); + $this->expectExceptionMessage('Invalid JSON response structure: missing response field'); + + new TestableJsonResponse($json); + } + + public function testBaseJsonResponseWithEmptyJson(): void + { + $json = ''; + + $this->expectException(\RuntimeException::class); + $this->expectExceptionMessage('Invalid JSON response:'); + + new TestableJsonResponse($json); + } + + public function testBaseJsonResponseWithNullJson(): void + { + $json = 'null'; + + $this->expectException(\RuntimeException::class); + $this->expectExceptionMessage('Invalid JSON response structure: missing response field'); + + new TestableJsonResponse($json); + } + + public function testBaseJsonResponseConstants(): void + { + $this->assertEquals('SUCCESS', BaseJsonResponse::SUCCESS); + $this->assertEquals('FAILED', BaseJsonResponse::FAILED); + } + + public function testBaseJsonResponseWithComplexResponse(): void + { + $json = json_encode([ + 'response' => [ + 'returncode' => 'SUCCESS', + 'message' => 'Complex operation completed', + 'messageKey' => 'complexSuccess', + 'data' => [ + 'id' => 123, + 'name' => 'Test Item', + 'metadata' => [ + 'created' => '2023-01-01', + 'updated' => '2023-01-02', + ], + ], + ], + ]); + + $response = new TestableJsonResponse($json); + + $this->assertTrue($response->success()); + // getMessage() only returns value for failed responses + $this->assertNull($response->getMessage()); + $this->assertNull($response->getMessageKey()); + + // Test that the raw JSON preserves the complex structure + $rawJson = $response->getRawJson(); + $decoded = json_decode($rawJson, true); + $this->assertEquals(123, $decoded['response']['data']['id']); + } + + public function testBaseJsonResponseWithMalformedReturnCode(): void + { + $json = json_encode([ + 'response' => [ + 'returncode' => 'UNKNOWN', + 'message' => 'Unknown status', + ], + ]); + + $response = new TestableJsonResponse($json); + + // Should handle unknown return codes gracefully + $this->assertFalse($response->success()); + $this->assertFalse($response->failed()); + $this->assertEquals('UNKNOWN', $response->getReturnCode()); + // Since it's not a FAILED response, getMessage() should return null + $this->assertNull($response->getMessage()); + } +} + +/** + * Testable concrete implementation of BaseJsonResponse for testing purposes. + */ +class TestableJsonResponse extends BaseJsonResponse +{ + // No additional methods needed - we're testing the base class functionality +} diff --git a/tests/Responses/CreateMeetingResponseTest.php b/tests/Responses/CreateMeetingResponseTest.php index 12eb6850..3c3d2dba 100644 --- a/tests/Responses/CreateMeetingResponseTest.php +++ b/tests/Responses/CreateMeetingResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/DeleteRecordingsResponseTest.php b/tests/Responses/DeleteRecordingsResponseTest.php index 524c860f..532b6842 100644 --- a/tests/Responses/DeleteRecordingsResponseTest.php +++ b/tests/Responses/DeleteRecordingsResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/EndMeetingResponseTest.php b/tests/Responses/EndMeetingResponseTest.php index a7e09b8d..ea266892 100644 --- a/tests/Responses/EndMeetingResponseTest.php +++ b/tests/Responses/EndMeetingResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/FeedbackResponseTest.php b/tests/Responses/FeedbackResponseTest.php new file mode 100644 index 00000000..5a2da3d7 --- /dev/null +++ b/tests/Responses/FeedbackResponseTest.php @@ -0,0 +1,230 @@ +. + */ + +namespace BigBlueButton\Responses; + +use BigBlueButton\TestCase; + +/** + * Class FeedbackResponseTest. + * + * @internal + */ +class FeedbackResponseTest extends TestCase +{ + public function testFeedbackResponse(): void + { + $json = $this->loadJsonFile('feedback_response.json'); + $response = new FeedbackResponse($json); + + $this->assertTrue($response->success()); + $this->assertEquals('ok', $response->getStatus()); + } + + public function testFeedbackResponseFields(): void + { + $json = $this->loadJsonFile('feedback_response.json'); + $response = new FeedbackResponse($json); + + // Test basic fields + $this->assertEquals('feedback-123456', $response->getFeedbackID()); + $this->assertEquals('session-token-789', $response->getSessionToken()); + $this->assertEquals('meeting456', $response->getMeetingID()); + $this->assertEquals('user123', $response->getUserID()); + $this->assertEquals(4, $response->getRating()); + $this->assertEquals('Great meeting experience!', $response->getComment()); + $this->assertEquals('2023-01-15T14:30:00Z', $response->getSubmittedAt()); + + // Test boolean fields + $this->assertTrue($response->getProcessed()); + $this->assertEquals('meeting_feedback', $response->getFeedbackType()); + } + + public function testFeedbackResponseWithMinimalData(): void + { + $json = $this->loadJsonFile('feedback_minimal_response.json'); + $response = new FeedbackResponse($json); + + $this->assertTrue($response->success()); + + // Test required fields + $this->assertNotEmpty($response->getFeedbackID()); + $this->assertNotEmpty($response->getSessionToken()); + + // Test optional fields are null when not present + $this->assertNull($response->getMeetingID()); + $this->assertNull($response->getUserID()); + $this->assertNull($response->getRating()); + $this->assertNull($response->getComment()); + $this->assertNull($response->getSubmittedAt()); + $this->assertFalse($response->getProcessed()); + $this->assertNull($response->getFeedbackType()); + } + + public function testFeedbackResponseWithAdditionalData(): void + { + $json = $this->loadJsonFile('feedback_with_additional_data_response.json'); + $response = new FeedbackResponse($json); + + $this->assertTrue($response->success()); + + $additionalData = $response->getAdditionalData(); + + $this->assertIsArray($additionalData); + $this->assertEquals('mobile', $additionalData['device-type']); + $this->assertEquals('iOS', $additionalData['platform']); + $this->assertEquals('2.1.0', $additionalData['client-version']); + + // Test getting specific additional data fields + $this->assertEquals('mobile', $response->getAdditionalDataField('device-type')); + $this->assertEquals('iOS', $response->getAdditionalDataField('platform')); + $this->assertEquals('2.1.0', $response->getAdditionalDataField('client-version')); + + // Test getting non-existent field with default + $this->assertEquals('default-value', $response->getAdditionalDataField('non-existent', 'default-value')); + $this->assertNull($response->getAdditionalDataField('non-existent')); + } + + public function testFeedbackResponseWithEmptyAdditionalData(): void + { + $json = $this->loadJsonFile('feedback_minimal_response.json'); + $response = new FeedbackResponse($json); + + $additionalData = $response->getAdditionalData(); + + $this->assertIsArray($additionalData); + $this->assertEmpty($additionalData); + + $this->assertNull($response->getAdditionalDataField('any-key')); + $this->assertEquals('default', $response->getAdditionalDataField('any-key', 'default')); + } + + public function testFeedbackResponseError(): void + { + $json = $this->loadJsonFile('feedback_error_response.json'); + $response = new FeedbackResponse($json); + + $this->assertFalse($response->success()); + $this->assertEquals('Invalid session token', $response->getMessage()); + $this->assertEquals('404', $response->getStatusCode()); + } + + public function testFeedbackResponseWithLongComment(): void + { + $json = $this->loadJsonFile('feedback_long_comment_response.json'); + $response = new FeedbackResponse($json); + + $this->assertTrue($response->success()); + + $comment = $response->getComment(); + $this->assertNotEmpty($comment); + $this->assertGreaterThan(100, mb_strlen($comment)); // Should be a long comment + } + + public function testFeedbackResponseWithDifferentRatings(): void + { + $ratings = [1, 2, 3, 4, 5]; + + foreach ($ratings as $rating) { + $json = $this->loadJsonFile("feedback_rating_{$rating}_response.json"); + $response = new FeedbackResponse($json); + + $this->assertTrue($response->success()); + $this->assertEquals($rating, $response->getRating()); + } + } + + private function loadJsonFile(string $filename): string + { + // Create mock JSON responses for testing + $responses = [ + 'feedback_response.json' => json_encode([ + 'response' => [ + 'returncode' => 'SUCCESS', + 'status' => 'ok', + 'feedback_id' => 'feedback-123456', + 'session_token' => 'session-token-789', + 'meeting_id' => 'meeting456', + 'user_id' => 'user123', + 'rating' => 4, + 'comment' => 'Great meeting experience!', + 'submitted_at' => '2023-01-15T14:30:00Z', + 'processed' => true, + 'feedback_type' => 'meeting_feedback', + ], + ]), + 'feedback_minimal_response.json' => json_encode([ + 'response' => [ + 'returncode' => 'SUCCESS', + 'status' => 'ok', + 'feedback_id' => 'feedback-minimal-789', + 'session_token' => 'minimal-session-token', + ], + ]), + 'feedback_with_additional_data_response.json' => json_encode([ + 'response' => [ + 'returncode' => 'SUCCESS', + 'status' => 'ok', + 'feedback_id' => 'feedback-additional-456', + 'session_token' => 'session-with-data-123', + 'rating' => 5, + 'additional_data' => [ + 'device-type' => 'mobile', + 'platform' => 'iOS', + 'client-version' => '2.1.0', + ], + ], + ]), + 'feedback_error_response.json' => json_encode([ + 'response' => [ + 'returncode' => 'FAILED', + 'status' => 'error', + 'message' => 'Invalid session token', + 'statuscode' => '404', + ], + ]), + 'feedback_long_comment_response.json' => json_encode([ + 'response' => [ + 'returncode' => 'SUCCESS', + 'status' => 'ok', + 'feedback_id' => 'feedback-long-comment-123', + 'session_token' => 'long-comment-session', + 'rating' => 3, + 'comment' => 'This is a very long comment about the meeting experience. It includes multiple sentences and provides detailed feedback about various aspects of the meeting including audio quality, video performance, user interface, and overall satisfaction. The comment is comprehensive and gives valuable insights for improving the meeting experience.', + ], + ]), + ]; + + // Add rating-specific responses + for ($i = 1; $i <= 5; ++$i) { + $responses["feedback_rating_{$i}_response.json"] = json_encode([ + 'response' => [ + 'returncode' => 'SUCCESS', + 'status' => 'ok', + 'feedback_id' => "feedback-rating-{$i}-123", + 'session_token' => "rating-session-{$i}", + 'rating' => $i, + ], + ]); + } + + return $responses[$filename] ?? $responses['feedback_minimal_response.json']; + } +} diff --git a/tests/Responses/GetJoinUrlResponseTest.php b/tests/Responses/GetJoinUrlResponseTest.php new file mode 100644 index 00000000..f80a5502 --- /dev/null +++ b/tests/Responses/GetJoinUrlResponseTest.php @@ -0,0 +1,196 @@ +. + */ + +namespace BigBlueButton\Responses; + +use BigBlueButton\TestCase; + +/** + * Class GetJoinUrlResponseTest. + * + * @internal + */ +class GetJoinUrlResponseTest extends TestCase +{ + public function testGetJoinUrlResponse(): void + { + $xml = $this->loadXmlFile('get_join_url_response.xml'); + $response = new GetJoinUrlResponse($xml); + + $this->assertTrue($response->success()); + $this->assertEquals('Successfully retrieved join URL', $response->getMessage()); + } + + public function testGetJoinUrlResponseFields(): void + { + $xml = $this->loadXmlFile('get_join_url_response.xml'); + $response = new GetJoinUrlResponse($xml); + + // Test basic fields + $this->assertEquals('https://bbb.example.com/join/session123456', $response->getUrl()); + $this->assertEquals('new-session-token-789', $response->getSessionToken()); + $this->assertEquals('user123', $response->getUserId()); + $this->assertEquals('meeting456', $response->getMeetingId()); + $this->assertEquals('auth-token-abc', $response->getAuthToken()); + $this->assertEquals('ALLOWED', $response->getGuestStatus()); + $this->assertEquals('John Doe', $response->getUserName()); + $this->assertEquals('2023-01-15T10:30:00Z', $response->getCreatedTime()); + + // Test optional fields + $this->assertEquals('https://bbb.example.com/redirect/session123456', $response->getRedirectUrl()); + $this->assertEquals('Mobile Device Session', $response->getSessionName()); + $this->assertTrue($response->isReplaceSession()); + $this->assertEquals('PRESENTATION_FOCUS', $response->getEnforceLayout()); + } + + public function testGetJoinUrlResponseWithMinimalData(): void + { + $xml = $this->loadXmlFile('get_join_url_minimal_response.xml'); + $response = new GetJoinUrlResponse($xml); + + $this->assertTrue($response->success()); + + // Test required fields + $this->assertNotEmpty($response->getUrl()); + $this->assertNotEmpty($response->getSessionToken()); + $this->assertNotEmpty($response->getUserId()); + $this->assertNotEmpty($response->getMeetingId()); + $this->assertNotEmpty($response->getAuthToken()); + + // Test optional fields are null when not present + $this->assertNull($response->getRedirectUrl()); + $this->assertNull($response->getSessionName()); + $this->assertFalse($response->isReplaceSession()); + $this->assertNull($response->getEnforceLayout()); + } + + public function testGetJoinUrlResponseWithUserdata(): void + { + $xml = $this->loadXmlFile('get_join_url_with_userdata_response.xml'); + $response = new GetJoinUrlResponse($xml); + + $this->assertTrue($response->success()); + + $userData = $response->getUserData(); + + $this->assertIsArray($userData); + $this->assertEquals('mobile', $userData['device-type']); + $this->assertEquals('dark', $userData['theme-preference']); + $this->assertEquals('user123', $userData['user-id']); + + // Test getting specific userdata parameters + $this->assertEquals('mobile', $response->getUserDataParam('device-type')); + $this->assertEquals('dark', $response->getUserDataParam('theme-preference')); + $this->assertEquals('user123', $response->getUserDataParam('user-id')); + + // Test getting non-existent parameter with default + $this->assertEquals('default-value', $response->getUserDataParam('non-existent', 'default-value')); + $this->assertNull($response->getUserDataParam('non-existent')); + } + + public function testGetJoinUrlResponseWithEmptyUserdata(): void + { + $xml = $this->loadXmlFile('get_join_url_minimal_response.xml'); + $response = new GetJoinUrlResponse($xml); + + $userData = $response->getUserData(); + + $this->assertIsArray($userData); + $this->assertEmpty($userData); + + $this->assertNull($response->getUserDataParam('any-key')); + $this->assertEquals('default', $response->getUserDataParam('any-key', 'default')); + } + + public function testGetJoinUrlResponseError(): void + { + $xml = $this->loadXmlFile('get_join_url_error_response.xml'); + $response = new GetJoinUrlResponse($xml); + + $this->assertFalse($response->success()); + $this->assertEquals('Invalid session token', $response->getMessage()); + $this->assertEquals('404', $response->getStatusCode()); + } + + private function loadXmlFile(string $filename): \SimpleXMLElement + { + // Create mock XML responses for testing + $responses = [ + 'get_join_url_response.xml' => ' + + SUCCESS + Successfully retrieved join URL + https://bbb.example.com/join/session123456 + new-session-token-789 + user123 + meeting456 + auth-token-abc + ALLOWED + John Doe + 2023-01-15T10:30:00Z + https://bbb.example.com/redirect/session123456 + Mobile Device Session + true + PRESENTATION_FOCUS +', + 'get_join_url_minimal_response.xml' => ' + + SUCCESS + Successfully retrieved join URL + https://bbb.example.com/join/session123456 + new-session-token-789 + user123 + meeting456 + auth-token-abc + ALLOWED + John Doe + 2023-01-15T10:30:00Z +', + 'get_join_url_with_userdata_response.xml' => ' + + SUCCESS + Successfully retrieved join URL + https://bbb.example.com/join/session123456 + new-session-token-789 + user123 + meeting456 + auth-token-abc + ALLOWED + John Doe + 2023-01-15T10:30:00Z + + mobile + dark + user123 + +', + 'get_join_url_error_response.xml' => ' + + FAILED + Invalid session token + 404 +', + ]; + + $xmlString = $responses[$filename] ?? $responses['get_join_url_minimal_response.xml']; + + return new \SimpleXMLElement($xmlString); + } +} diff --git a/tests/Responses/GetMeetingInfoResponseTest.php b/tests/Responses/GetMeetingInfoResponseTest.php index 701ca2ea..daf9f9fb 100644 --- a/tests/Responses/GetMeetingInfoResponseTest.php +++ b/tests/Responses/GetMeetingInfoResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -21,6 +21,7 @@ namespace BigBlueButton\Responses; use BigBlueButton\Core\Meeting; +use BigBlueButton\Enum\Role; use BigBlueButton\TestCase; use BigBlueButton\TestServices\Fixtures; @@ -82,7 +83,7 @@ public function testMeetingAttendeeContent(): void $this->assertEquals('xi7y7gpmyq1g', $anAttendee->getUserId()); $this->assertEquals('Barrett Kutch', $anAttendee->getFullName()); - $this->assertEquals('MODERATOR', $anAttendee->getRole()); + $this->assertEquals(Role::MODERATOR, $anAttendee->getRole()); $this->assertFalse($anAttendee->isPresenter()); $this->assertFalse($anAttendee->isListeningOnly()); $this->assertTrue($anAttendee->hasJoinedVoice()); @@ -104,11 +105,11 @@ public function testMeetingModerators(): void $firstModerator = $moderators[0]; $this->assertEquals('Ernie Abernathy', $firstModerator->getFullName()); - $this->assertEquals('MODERATOR', $firstModerator->getRole()); + $this->assertEquals(Role::MODERATOR, $firstModerator->getRole()); $secondModerator = $moderators[1]; $this->assertEquals('Barrett Kutch', $secondModerator->getFullName()); - $this->assertEquals('MODERATOR', $secondModerator->getRole()); + $this->assertEquals(Role::MODERATOR, $secondModerator->getRole()); } public function testMeetingViewers(): void @@ -119,11 +120,11 @@ public function testMeetingViewers(): void $firstViewer = $viewers[0]; $this->assertEquals('Peter Parker', $firstViewer->getFullName()); - $this->assertEquals('VIEWER', $firstViewer->getRole()); + $this->assertEquals(Role::VIEWER, $firstViewer->getRole()); $secondViewer = $viewers[1]; $this->assertEquals('Bruce Wayne', $secondViewer->getFullName()); - $this->assertEquals('VIEWER', $secondViewer->getRole()); + $this->assertEquals(Role::VIEWER, $secondViewer->getRole()); } public function testGetMeetingInfoResponseTypes(): void @@ -142,7 +143,9 @@ public function testGetMeetingInfoResponseTypes(): void $anAttendee = $this->meetingInfo->getMeeting()->getAttendees()[1]; - $this->assertEachGetterValueIsString($anAttendee, ['getUserId', 'getFullName', 'getRole', 'getClientType']); + $this->assertInstanceOf(Role::class, $anAttendee->getRole()); + + $this->assertEachGetterValueIsString($anAttendee, ['getUserId', 'getFullName', 'getClientType']); $this->assertEachGetterValueIsBoolean($anAttendee, ['isPresenter', 'isListeningOnly', 'hasJoinedVoice', 'hasVideo']); } diff --git a/tests/Responses/GetMeetingsResponseTest.php b/tests/Responses/GetMeetingsResponseTest.php index 3cdf3b2f..98f0faff 100644 --- a/tests/Responses/GetMeetingsResponseTest.php +++ b/tests/Responses/GetMeetingsResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/GetRecordingsResponseTest.php b/tests/Responses/GetRecordingsResponseTest.php index 15dbe65a..0fba92ef 100644 --- a/tests/Responses/GetRecordingsResponseTest.php +++ b/tests/Responses/GetRecordingsResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -51,13 +51,16 @@ public function testGetRecordingResponseContent(): void $this->assertEquals('9d287cf50490ca856ca5273bd303a7e321df6051-4-119[0]', $aRecord->getMeetingId()); $this->assertEquals('f71d810b6e90a4a34ae02b8c7143e8733178578e-1462980100026', $aRecord->getRecordId()); + $this->assertEquals('f71d810b6e90a4a34ae02b8c7143e8733178578e-1462980100026', $aRecord->getInternalMeetingID()); $this->assertEquals('SAT- Writing Section- Social Science and History (All participants)', $aRecord->getName()); $this->assertTrue($aRecord->isPublished()); $this->assertEquals('published', $aRecord->getState()); $this->assertEquals(1462980100026, $aRecord->getStartTime()); $this->assertEquals(1462986640649, $aRecord->getEndTime()); + $this->assertEquals(6, $aRecord->getParticipants()); + $this->assertEquals(7219530, $aRecord->getRawSize()); $this->assertEquals('presentation', $aRecord->getPlaybackType()); - $this->assertEquals('http://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462980100026', $aRecord->getPlaybackUrl()); + $this->assertEquals('https://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462980100026', $aRecord->getPlaybackUrl()); $this->assertEquals(86, $aRecord->getPlaybackLength()); $this->assertEquals(9, sizeof($aRecord->getMetas())); } @@ -86,7 +89,7 @@ public function testRecordingsPlaybackFormats(): void $presentationFormat = $aRecord->getFormats()[1]; // having images preview $this->assertEquals('presentation', $presentationFormat->getType()); - $this->assertEquals('http://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462807897120', $presentationFormat->getUrl()); + $this->assertEquals('https://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462807897120', $presentationFormat->getUrl()); $this->assertEquals(2973, $presentationFormat->getProcessingTime()); $this->assertEquals(532, $presentationFormat->getLength()); $this->assertEquals(168019, $presentationFormat->getSize()); diff --git a/tests/Responses/GetRecordingsTextTracksResponseTest.php b/tests/Responses/GetRecordingsTextTracksResponseTest.php index 9d6b2c75..7e47311c 100644 --- a/tests/Responses/GetRecordingsTextTracksResponseTest.php +++ b/tests/Responses/GetRecordingsTextTracksResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/HooksCreateResponseTest.php b/tests/Responses/HooksCreateResponseTest.php index df9cc097..9ca76dbf 100644 --- a/tests/Responses/HooksCreateResponseTest.php +++ b/tests/Responses/HooksCreateResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -29,9 +29,8 @@ class HooksCreateResponseTest extends TestCase { private HooksCreateResponse $createResponseCreate; - private HooksCreateResponse $createResponseError; - private HooksCreateResponse $createResponseExisting; - private HooksCreateResponse $createResponseNoHookId; + private HooksCreateResponse $createResponseFailedError; + private HooksCreateResponse $createResponseCreateExisting; public function setUp(): void { @@ -39,15 +38,13 @@ public function setUp(): void $fixtures = new Fixtures(); - $xmlCreate = $fixtures->fromXmlFile('hooks_create.xml'); - $xmlCreateError = $fixtures->fromXmlFile('hooks_create_error.xml'); - $xmlCreateExisting = $fixtures->fromXmlFile('hooks_create_existing.xml'); - $xmlCreateNoHookId = $fixtures->fromXmlFile('hooks_create_no_hook_id.xml'); + $xmlCreate = $fixtures->fromXmlFile('hooks_create.xml'); + $xmlCreateExisting = $fixtures->fromXmlFile('hooks_create_existing.xml'); + $xmlCreateFailedError = $fixtures->fromXmlFile('hooks_create_failed_error.xml'); - $this->createResponseCreate = new HooksCreateResponse($xmlCreate); - $this->createResponseError = new HooksCreateResponse($xmlCreateError); - $this->createResponseExisting = new HooksCreateResponse($xmlCreateExisting); - $this->createResponseNoHookId = new HooksCreateResponse($xmlCreateNoHookId); + $this->createResponseCreate = new HooksCreateResponse($xmlCreate); + $this->createResponseCreateExisting = new HooksCreateResponse($xmlCreateExisting); + $this->createResponseFailedError = new HooksCreateResponse($xmlCreateFailedError); } public function testHooksCreateResponseCreateContent(): void @@ -63,51 +60,35 @@ public function testHooksCreateResponseCreateContent(): void public function testHooksCreateResponseErrorContent(): void { - $this->assertEquals('FAILED', $this->createResponseError->getReturnCode()); - $this->assertEquals('createHookError', $this->createResponseError->getMessageKey()); - $this->assertFalse($this->createResponseError->success()); - $this->assertTrue($this->createResponseError->failed()); - $this->assertNull($this->createResponseError->getHookId()); - $this->assertNull($this->createResponseError->isPermanentHook()); - $this->assertNull($this->createResponseError->hasRawData()); + $this->assertEquals('FAILED', $this->createResponseFailedError->getReturnCode()); + $this->assertEquals('createHookError', $this->createResponseFailedError->getMessageKey()); + $this->assertFalse($this->createResponseFailedError->success()); + $this->assertTrue($this->createResponseFailedError->failed()); + $this->assertNull($this->createResponseFailedError->getHookId()); + $this->assertNull($this->createResponseFailedError->isPermanentHook()); + $this->assertNull($this->createResponseFailedError->hasRawData()); } public function testHooksCreateResponseExistingContent(): void { - $this->assertEquals('SUCCESS', $this->createResponseExisting->getReturnCode()); - $this->assertEquals('duplicateWarning', $this->createResponseExisting->getMessageKey()); - $this->assertTrue($this->createResponseExisting->success()); - $this->assertFalse($this->createResponseExisting->failed()); - $this->assertEquals(1, $this->createResponseExisting->getHookId()); - $this->assertNull($this->createResponseExisting->isPermanentHook()); - $this->assertNull($this->createResponseExisting->hasRawData()); - } - - public function testHooksCreateResponseNoHookIdContent(): void - { - $this->assertEquals('FAILED', $this->createResponseNoHookId->getReturnCode()); - $this->assertEquals('missingParamHookID', $this->createResponseNoHookId->getMessageKey()); - $this->assertFalse($this->createResponseNoHookId->success()); - $this->assertTrue($this->createResponseNoHookId->failed()); - $this->assertNull($this->createResponseNoHookId->getHookId()); - $this->assertNull($this->createResponseNoHookId->isPermanentHook()); - $this->assertNull($this->createResponseNoHookId->hasRawData()); + $this->assertEquals('SUCCESS', $this->createResponseCreateExisting->getReturnCode()); + $this->assertEquals('duplicateWarning', $this->createResponseCreateExisting->getMessageKey()); + $this->assertTrue($this->createResponseCreateExisting->success()); + $this->assertFalse($this->createResponseCreateExisting->failed()); + $this->assertEquals(1, $this->createResponseCreateExisting->getHookId()); + $this->assertNull($this->createResponseCreateExisting->isPermanentHook()); + $this->assertNull($this->createResponseCreateExisting->hasRawData()); } public function testHooksCreateResponseTypes(): void { - $this->assertEachGetterValueIsString($this->createResponseCreate, ['getReturnCode']); - $this->assertEachGetterValueIsInteger($this->createResponseCreate, ['getHookId']); + $this->assertEachGetterValueIsString($this->createResponseCreate, ['getReturnCode', 'getHookId']); $this->assertEachGetterValueIsBoolean($this->createResponseCreate, ['isPermanentHook', 'hasRawData']); - $this->assertEachGetterValueIsString($this->createResponseError, ['getReturnCode']); - $this->assertEachGetterValueIsNull($this->createResponseError, ['getHookId', 'isPermanentHook', 'hasRawData']); - - $this->assertEachGetterValueIsString($this->createResponseExisting, ['getReturnCode']); - $this->assertEachGetterValueIsInteger($this->createResponseExisting, ['getHookId']); - $this->assertEachGetterValueIsNull($this->createResponseExisting, ['isPermanentHook', 'hasRawData']); + $this->assertEachGetterValueIsString($this->createResponseFailedError, ['getReturnCode']); + $this->assertEachGetterValueIsNull($this->createResponseFailedError, ['getHookId', 'isPermanentHook', 'hasRawData']); - $this->assertEachGetterValueIsString($this->createResponseNoHookId, ['getReturnCode']); - $this->assertEachGetterValueIsNull($this->createResponseNoHookId, ['getHookId', 'isPermanentHook', 'hasRawData']); + $this->assertEachGetterValueIsString($this->createResponseCreateExisting, ['getReturnCode', 'getHookId']); + $this->assertEachGetterValueIsNull($this->createResponseCreateExisting, ['isPermanentHook', 'hasRawData']); } } diff --git a/tests/Responses/HooksDestroyResponseTest.php b/tests/Responses/HooksDestroyResponseTest.php index 70593468..174159e0 100644 --- a/tests/Responses/HooksDestroyResponseTest.php +++ b/tests/Responses/HooksDestroyResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -29,9 +29,9 @@ class HooksDestroyResponseTest extends TestCase { private HooksDestroyResponse $destroyResponse; - private HooksDestroyResponse $destroyResponseError; - private HooksDestroyResponse $destroyResponseNotFound; - private HooksDestroyResponse $destroyResponseParamsNoId; + private HooksDestroyResponse $destroyResponseFailedError; + private HooksDestroyResponse $destroyResponseFailedNotFound; + private HooksDestroyResponse $destroyResponseFailedNoId; public function setUp(): void { @@ -39,15 +39,15 @@ public function setUp(): void $fixtures = new Fixtures(); - $xml = $fixtures->fromXmlFile('hooks_destroy.xml'); - $xmlError = $fixtures->fromXmlFile('hooks_destroy_error.xml'); - $xmlNotFound = $fixtures->fromXmlFile('hooks_destroy_not_found.xml'); - $xmlParamsNoId = $fixtures->fromXmlFile('hooks_destroy_params_no_id.xml'); + $xml = $fixtures->fromXmlFile('hooks_destroy.xml'); + $xmlFailedError = $fixtures->fromXmlFile('hooks_destroy_failed_error.xml'); + $xmlFailedNoId = $fixtures->fromXmlFile('hooks_destroy_failed_no_id.xml'); + $xmlFailedNotFound = $fixtures->fromXmlFile('hooks_destroy_failed_not_found.xml'); - $this->destroyResponse = new HooksDestroyResponse($xml); - $this->destroyResponseError = new HooksDestroyResponse($xmlError); - $this->destroyResponseNotFound = new HooksDestroyResponse($xmlNotFound); - $this->destroyResponseParamsNoId = new HooksDestroyResponse($xmlParamsNoId); + $this->destroyResponse = new HooksDestroyResponse($xml); + $this->destroyResponseFailedError = new HooksDestroyResponse($xmlFailedError); + $this->destroyResponseFailedNoId = new HooksDestroyResponse($xmlFailedNoId); + $this->destroyResponseFailedNotFound = new HooksDestroyResponse($xmlFailedNotFound); } public function testHooksDestroyResponseContent(): void @@ -59,23 +59,23 @@ public function testHooksDestroyResponseContent(): void public function testHooksDestroyErrorResponseContent(): void { - $this->assertEquals('FAILED', $this->destroyResponseError->getReturnCode()); - $this->assertEquals('destroyHookError', $this->destroyResponseError->getMessageKey()); - $this->assertNull($this->destroyResponseError->removed()); + $this->assertEquals('FAILED', $this->destroyResponseFailedError->getReturnCode()); + $this->assertEquals('destroyHookError', $this->destroyResponseFailedError->getMessageKey()); + $this->assertNull($this->destroyResponseFailedError->removed()); } public function testHooksDestroyNotFoundResponseContent(): void { - $this->assertEquals('FAILED', $this->destroyResponseNotFound->getReturnCode()); - $this->assertEquals('destroyMissingHook', $this->destroyResponseNotFound->getMessageKey()); - $this->assertNull($this->destroyResponseNotFound->removed()); + $this->assertEquals('FAILED', $this->destroyResponseFailedNotFound->getReturnCode()); + $this->assertEquals('destroyMissingHook', $this->destroyResponseFailedNotFound->getMessageKey()); + $this->assertNull($this->destroyResponseFailedNotFound->removed()); } public function testHooksDestroyParamsNoIdContent(): void { - $this->assertEquals('FAILED', $this->destroyResponseParamsNoId->getReturnCode()); - $this->assertEquals('missingParamHookID', $this->destroyResponseParamsNoId->getMessageKey()); - $this->assertNull($this->destroyResponseParamsNoId->removed()); + $this->assertEquals('FAILED', $this->destroyResponseFailedNoId->getReturnCode()); + $this->assertEquals('missingParamHookID', $this->destroyResponseFailedNoId->getMessageKey()); + $this->assertNull($this->destroyResponseFailedNoId->removed()); } public function testHooksDestroyResponseTypes(): void @@ -83,13 +83,13 @@ public function testHooksDestroyResponseTypes(): void $this->assertEachGetterValueIsString($this->destroyResponse, ['getReturnCode']); $this->assertEachGetterValueIsBoolean($this->destroyResponse, ['removed']); - $this->assertEachGetterValueIsString($this->destroyResponseError, ['getReturnCode']); - $this->assertEachGetterValueIsNull($this->destroyResponseError, ['removed']); + $this->assertEachGetterValueIsString($this->destroyResponseFailedError, ['getReturnCode']); + $this->assertEachGetterValueIsNull($this->destroyResponseFailedError, ['removed']); - $this->assertEachGetterValueIsString($this->destroyResponseNotFound, ['getReturnCode']); - $this->assertEachGetterValueIsNull($this->destroyResponseNotFound, ['removed']); + $this->assertEachGetterValueIsString($this->destroyResponseFailedNotFound, ['getReturnCode']); + $this->assertEachGetterValueIsNull($this->destroyResponseFailedNotFound, ['removed']); - $this->assertEachGetterValueIsString($this->destroyResponseParamsNoId, ['getReturnCode']); - $this->assertEachGetterValueIsNull($this->destroyResponseParamsNoId, ['removed']); + $this->assertEachGetterValueIsString($this->destroyResponseFailedNoId, ['getReturnCode']); + $this->assertEachGetterValueIsNull($this->destroyResponseFailedNoId, ['removed']); } } diff --git a/tests/Responses/HooksListResponseTest.php b/tests/Responses/HooksListResponseTest.php index af49efd7..570a0853 100644 --- a/tests/Responses/HooksListResponseTest.php +++ b/tests/Responses/HooksListResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -72,8 +72,7 @@ public function testHooksListResponseTypes(): void $aHook = $this->hooksListResponse->getHooks()[0]; - $this->assertEachGetterValueIsString($aHook, ['getCallbackUrl', 'getMeetingId']); - $this->assertEachGetterValueIsInteger($aHook, ['getHookId']); + $this->assertEachGetterValueIsString($aHook, ['getCallbackUrl', 'getMeetingId', 'getHookId']); $this->assertEachGetterValueIsBoolean($aHook, ['hasRawData', 'isPermanentHook']); } } diff --git a/tests/Responses/InsertDocumentResponseTest.php b/tests/Responses/InsertDocumentResponseTest.php index ebf218e6..cc0b7f86 100644 --- a/tests/Responses/InsertDocumentResponseTest.php +++ b/tests/Responses/InsertDocumentResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/IsMeetingRunningResponseTest.php b/tests/Responses/IsMeetingRunningResponseTest.php index c894689a..62e8b22f 100644 --- a/tests/Responses/IsMeetingRunningResponseTest.php +++ b/tests/Responses/IsMeetingRunningResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/JoinMeetingResponseTest.php b/tests/Responses/JoinMeetingResponseTest.php index 18e2772c..d0be9954 100644 --- a/tests/Responses/JoinMeetingResponseTest.php +++ b/tests/Responses/JoinMeetingResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/PublishRecordingsResponseTest.php b/tests/Responses/PublishRecordingsResponseTest.php index f547a07a..3a374fb8 100644 --- a/tests/Responses/PublishRecordingsResponseTest.php +++ b/tests/Responses/PublishRecordingsResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/Responses/SendChatMessageResponseTest.php b/tests/Responses/SendChatMessageResponseTest.php new file mode 100644 index 00000000..807e34bd --- /dev/null +++ b/tests/Responses/SendChatMessageResponseTest.php @@ -0,0 +1,53 @@ +. + */ + +namespace BigBlueButton\Responses; + +use BigBlueButton\TestCase; +use BigBlueButton\TestServices\Fixtures; + +/** + * @internal + */ +class SendChatMessageResponseTest extends TestCase +{ + private SendChatMessageResponse $sendChatMessage; + + public function setUp(): void + { + parent::setUp(); + $fixtures = new Fixtures(); + + $xml = $fixtures->fromXmlFile('send_chat_message.xml'); + + $this->sendChatMessage = new SendChatMessageResponse($xml); + } + + public function testSendChatMessageResponseContent(): void + { + $this->assertEquals('SUCCESS', $this->sendChatMessage->getReturnCode()); + $this->assertEquals('', $this->sendChatMessage->getMessageKey()); + } + + public function testSendChatMessageResponseTypes(): void + { + $this->assertEachGetterValueIsString($this->sendChatMessage, ['getReturnCode', 'getMessageKey']); + } +} diff --git a/tests/Responses/UpdateRecordingsResponseTest.php b/tests/Responses/UpdateRecordingsResponseTest.php index 0c153a05..8e27197f 100644 --- a/tests/Responses/UpdateRecordingsResponseTest.php +++ b/tests/Responses/UpdateRecordingsResponseTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/TestCase.php b/tests/TestCase.php index 48a395de..5ebdccd4 100644 --- a/tests/TestCase.php +++ b/tests/TestCase.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -51,10 +51,7 @@ public function setUp(): void // Additional assertions - /** - * @param mixed $actual - */ - public function assertIsInteger($actual, string $message = ''): void + public function assertIsInteger(mixed $actual, string $message = ''): void { if (empty($message)) { $message = 'Got a ' . gettype($actual) . ' instead of an integer.'; @@ -62,10 +59,7 @@ public function assertIsInteger($actual, string $message = ''): void $this->assertTrue(is_integer($actual), $message); } - /** - * @param mixed $actual - */ - public function assertIsDouble($actual, string $message = ''): void + public function assertIsDouble(mixed $actual, string $message = ''): void { if (empty($message)) { $message = 'Got a ' . gettype($actual) . ' instead of a double.'; @@ -73,10 +67,7 @@ public function assertIsDouble($actual, string $message = ''): void $this->assertTrue(is_double($actual), $message); } - /** - * @param mixed $actual - */ - public function assertIsBoolean($actual, string $message = ''): void + public function assertIsBoolean(mixed $actual, string $message = ''): void { if (empty($message)) { $message = 'Got a ' . gettype($actual) . ' instead of a boolean.'; @@ -85,10 +76,9 @@ public function assertIsBoolean($actual, string $message = ''): void } /** - * @param mixed $obj * @param array $getters */ - public function assertEachGetterValueIsString($obj, array $getters): void + public function assertEachGetterValueIsString(mixed $obj, array $getters): void { foreach ($getters as $getterName) { $this->assertIsString($obj->{$getterName}(), 'Got a ' . gettype($obj->{$getterName}()) . ' instead of a string for property -> ' . $getterName); @@ -96,10 +86,9 @@ public function assertEachGetterValueIsString($obj, array $getters): void } /** - * @param mixed $obj * @param array $getters */ - public function assertEachGetterValueIsInteger($obj, array $getters): void + public function assertEachGetterValueIsInteger(mixed $obj, array $getters): void { foreach ($getters as $getterName) { $this->assertIsInteger($obj->{$getterName}(), 'Got a ' . gettype($obj->{$getterName}()) . ' instead of an integer for property -> ' . $getterName); @@ -107,10 +96,9 @@ public function assertEachGetterValueIsInteger($obj, array $getters): void } /** - * @param mixed $obj * @param array $getters */ - public function assertEachGetterValueIsNull($obj, array $getters): void + public function assertEachGetterValueIsNull(mixed $obj, array $getters): void { foreach ($getters as $getterName) { $this->assertNull($obj->{$getterName}(), 'Got a ' . gettype($obj->{$getterName}()) . ' instead of NULL for property -> ' . $getterName); @@ -118,10 +106,9 @@ public function assertEachGetterValueIsNull($obj, array $getters): void } /** - * @param mixed $obj * @param array $getters */ - public function assertEachGetterValueIsDouble($obj, array $getters): void + public function assertEachGetterValueIsDouble(mixed $obj, array $getters): void { foreach ($getters as $getterName) { $this->assertIsDouble($obj->{$getterName}(), 'Got a ' . gettype($obj->{$getterName}()) . ' instead of a double for property -> ' . $getterName); @@ -129,10 +116,9 @@ public function assertEachGetterValueIsDouble($obj, array $getters): void } /** - * @param mixed $obj * @param array $getters */ - public function assertEachGetterValueIsBoolean($obj, array $getters): void + public function assertEachGetterValueIsBoolean(mixed $obj, array $getters): void { foreach ($getters as $getterName) { $this->assertIsBoolean($obj->{$getterName}(), 'Got a ' . gettype($obj->{$getterName}()) . ' instead of a boolean for property -> ' . $getterName); @@ -175,7 +161,7 @@ protected function generateCreateParams(): array 'lockSettingsDisableMic' => $this->faker->boolean(50), 'lockSettingsDisablePrivateChat' => $this->faker->boolean(50), 'lockSettingsDisablePublicChat' => $this->faker->boolean(50), - 'lockSettingsDisableNote' => $this->faker->boolean(50), + 'lockSettingsDisableNotes' => $this->faker->boolean(50), 'lockSettingsHideUserList' => $this->faker->boolean(50), 'lockSettingsLockedLayout' => $this->faker->boolean(50), 'lockSettingsLockOnJoin' => $this->faker->boolean(50), @@ -183,7 +169,7 @@ protected function generateCreateParams(): array 'lockSettingsHideViewersCursor' => $this->faker->boolean(50), 'allowModsToUnmuteUsers' => $this->faker->boolean(50), 'allowModsToEjectCameras' => $this->faker->boolean(50), - 'guestPolicy' => $this->faker->randomElement(GuestPolicy::getValues()), + 'guestPolicy' => Fixtures::randomEnumValues($this->faker, GuestPolicy::class, 1), 'endWhenNoModerator' => $this->faker->boolean(50), 'endWhenNoModeratorDelayInMinutes' => $this->faker->numberBetween(1, 30), 'meetingKeepEvents' => $this->faker->boolean(50), @@ -198,14 +184,14 @@ protected function generateCreateParams(): array 'breakoutRoomsRecord' => $this->faker->boolean(50), 'breakoutRoomsPrivateChatEnabled' => $this->faker->boolean(50), 'meetingEndedURL' => $this->faker->url, - 'meetingLayout' => $this->faker->randomElement(MeetingLayout::getValues()), + 'meetingLayout' => Fixtures::randomEnumValues($this->faker, MeetingLayout::class, 1), 'meetingCameraCap' => $this->faker->numberBetween(1, 3), 'meetingExpireIfNoUserJoinedInMinutes' => $this->faker->numberBetween(1, 10), 'meetingExpireWhenLastUserLeftInMinutes' => $this->faker->numberBetween(5, 15), 'preUploadedPresentationOverrideDefault' => $this->faker->boolean, 'groups' => $this->generateBreakoutRoomsGroups(), - 'disabledFeatures' => $this->faker->randomElements(Feature::getValues()), - 'disabledFeaturesExclude' => $this->faker->randomElements(Feature::getValues()), + 'disabledFeatures' => Fixtures::randomEnumValues($this->faker, Feature::class, null, 'array'), + 'disabledFeaturesExclude' => Fixtures::randomEnumValues($this->faker, Feature::class, null, 'array'), 'meta_presenter' => $this->faker->name, 'meta_endCallbackUrl' => $this->faker->url, 'meta_bbb-recording-ready-url' => $this->faker->url, @@ -235,11 +221,9 @@ protected function generateBreakoutRoomsGroups(): array } /** - * @param mixed $createParams - * * @return array */ - protected function generateBreakoutCreateParams($createParams): array + protected function generateBreakoutCreateParams(mixed $createParams): array { return array_merge($createParams, [ 'isBreakout' => true, @@ -284,7 +268,8 @@ protected function getCreateMock(array $params): CreateMeetingParameters ->setLockSettingsDisableMic($params['lockSettingsDisableMic']) ->setLockSettingsDisablePrivateChat($params['lockSettingsDisablePrivateChat']) ->setLockSettingsDisablePublicChat($params['lockSettingsDisablePublicChat']) - ->setLockSettingsDisableNote($params['lockSettingsDisableNote']) + ->setLockSettingsDisableNote($params['lockSettingsDisableNotes']) + ->setLockSettingsDisableNotes($params['lockSettingsDisableNotes']) ->setLockSettingsHideUserList($params['lockSettingsHideUserList']) ->setLockSettingsLockedLayout($params['lockSettingsLockedLayout']) ->setLockSettingsLockOnJoin($params['lockSettingsLockOnJoin']) @@ -323,15 +308,13 @@ protected function getCreateMock(array $params): CreateMeetingParameters ; } - /** - * @param mixed $params - */ - protected function getBreakoutCreateMock($params): CreateMeetingParameters + protected function getBreakoutCreateMock(mixed $params): CreateMeetingParameters { $createMeetingParams = $this->getCreateMock($params); - return $createMeetingParams->setBreakout($params['isBreakout'])->setParentMeetingId($params['parentMeetingId'])-> - setSequence($params['sequence'])->setFreeJoin($params['freeJoin']); + return $createMeetingParams->setBreakout($params['isBreakout'])->setParentMeetingId($params['parentMeetingId']) + ->setSequence($params['sequence'])->setFreeJoin($params['freeJoin']) + ; } /** @@ -346,7 +329,7 @@ protected function generateJoinMeetingParams(): array 'userId' => $this->faker->numberBetween(1, 1000), 'webVoiceConf' => $this->faker->word, 'creationTime' => $this->faker->unixTime, - 'role' => $this->faker->randomElement(Role::getValues()), + 'role' => Fixtures::randomEnumValues($this->faker, Role::class, 1), 'excludeFromDashboard' => $this->faker->boolean, 'userdata_countrycode' => $this->faker->countryCode, 'userdata_email' => $this->faker->email, diff --git a/tests/TestServices/EnvLoader.php b/tests/TestServices/EnvLoader.php index c44ba79b..ffdaed7e 100644 --- a/tests/TestServices/EnvLoader.php +++ b/tests/TestServices/EnvLoader.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/TestServices/Fixtures.php b/tests/TestServices/Fixtures.php index 7040803f..b30de963 100644 --- a/tests/TestServices/Fixtures.php +++ b/tests/TestServices/Fixtures.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -29,15 +29,19 @@ use BigBlueButton\Parameters\JoinMeetingParameters; use BigBlueButton\Parameters\UpdateRecordingsParameters; use Faker\Factory as Faker; +use Faker\Generator; class Fixtures { - public const PATH = __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'tests' . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR; + public const RESPONSE_PATH = self::BASE_PATH . 'responses' . DIRECTORY_SEPARATOR; + public const REQUEST_PATH = self::BASE_PATH . 'requests' . DIRECTORY_SEPARATOR; + public const IMAGE_PATH = self::BASE_PATH . 'images' . DIRECTORY_SEPARATOR; + private const BASE_PATH = __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'tests' . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR; // LOADERS --------------------------------------------------------------------------------------------------------- public static function fromXmlFile(string $filename): \SimpleXMLElement { - $uri = self::PATH . $filename; + $uri = self::RESPONSE_PATH . DIRECTORY_SEPARATOR . $filename; if (!file_exists($uri)) { throw new \RuntimeException("File '{$uri}' not found."); @@ -60,7 +64,7 @@ public static function fromXmlFile(string $filename): \SimpleXMLElement public static function fromJsonFile(string $filename): string { - $uri = self::PATH . $filename; + $uri = self::BASE_PATH . 'responses' . DIRECTORY_SEPARATOR . $filename; if (!file_exists($uri)) { throw new \RuntimeException("File '{$uri}' not found."); @@ -75,6 +79,49 @@ public static function fromJsonFile(string $filename): string return $content; } + /** + * Gets random enum cases with flexible return formats. + * + * @param Generator $faker Faker generator instance + * @param class-string<\BackedEnum> $enumClass Enum class name + * @param null|int $count Number of items to return + * @param string $format 'array' (cases), 'values' or 'single' + * + * @return array<\BackedEnum>|array|\BackedEnum|string + * + * @throws \InvalidArgumentException + */ + public static function randomEnumValues( + Generator $faker, + string $enumClass, + ?int $count = null, + string $format = 'single' + ) { + if (!is_subclass_of($enumClass, \BackedEnum::class)) { + throw new \InvalidArgumentException('Given class must be a BackedEnum'); + } + + /** @var array<\BackedEnum> $cases */ + $cases = $enumClass::cases(); + $count ??= $faker->numberBetween(1, count($cases)); + $count = min($count, count($cases)); + + /** @var array<\BackedEnum> $selected */ + $selected = $faker->randomElements($cases, $count); + + switch ($format) { + case 'values': + /** @var array $values */ + $values = array_map(fn (\BackedEnum $case) => $case->value, $selected); + + return $values; + case 'single': + return $selected[0]; + default: // 'array' + return $selected; + } + } + // GENERATORS ------------------------------------------------------------------------------------------------------ /** * @return array @@ -107,7 +154,7 @@ public static function generateCreateParams(): array 'lockSettingsDisableMic' => $faker->boolean(50), 'lockSettingsDisablePrivateChat' => $faker->boolean(50), 'lockSettingsDisablePublicChat' => $faker->boolean(50), - 'lockSettingsDisableNote' => $faker->boolean(50), + 'lockSettingsDisableNotes' => $faker->boolean(50), 'lockSettingsHideUserList' => $faker->boolean(50), 'lockSettingsLockedLayout' => $faker->boolean(50), 'lockSettingsLockOnJoin' => $faker->boolean(50), @@ -115,7 +162,7 @@ public static function generateCreateParams(): array 'lockSettingsHideViewersCursor' => $faker->boolean(50), 'allowModsToUnmuteUsers' => $faker->boolean(50), 'allowModsToEjectCameras' => $faker->boolean(50), - 'guestPolicy' => $faker->randomElement(GuestPolicy::getValues()), + 'guestPolicy' => self::randomEnumValues($faker, GuestPolicy::class, 1), 'endWhenNoModerator' => $faker->boolean(50), 'endWhenNoModeratorDelayInMinutes' => $faker->numberBetween(1, 30), 'meetingKeepEvents' => $faker->boolean(50), @@ -130,14 +177,14 @@ public static function generateCreateParams(): array 'breakoutRoomsRecord' => $faker->boolean(50), 'breakoutRoomsPrivateChatEnabled' => $faker->boolean(50), 'meetingEndedURL' => $faker->url, - 'meetingLayout' => $faker->randomElement(MeetingLayout::getValues()), + 'meetingLayout' => self::randomEnumValues($faker, MeetingLayout::class, 1), 'meetingCameraCap' => $faker->numberBetween(1, 3), 'meetingExpireIfNoUserJoinedInMinutes' => $faker->numberBetween(1, 10), 'meetingExpireWhenLastUserLeftInMinutes' => $faker->numberBetween(5, 15), 'preUploadedPresentationOverrideDefault' => $faker->boolean, 'groups' => Fixtures::generateBreakoutRoomsGroups(), - 'disabledFeatures' => $faker->randomElements(Feature::getValues()), - 'disabledFeaturesExclude' => $faker->randomElements(Feature::getValues()), + 'disabledFeatures' => self::randomEnumValues($faker, Feature::class, null, 'array'), + 'disabledFeaturesExclude' => self::randomEnumValues($faker, Feature::class, null, 'array'), 'meta_presenter' => $faker->name, 'meta_endCallbackUrl' => $faker->url, 'meta_bbb-recording-ready-url' => $faker->url, @@ -169,11 +216,9 @@ public static function generateBreakoutRoomsGroups(): array } /** - * @param mixed $createParams - * * @return array */ - public static function generateBreakoutCreateParams($createParams): array + public static function generateBreakoutCreateParams(mixed $createParams): array { $faker = Faker::create(); @@ -199,7 +244,7 @@ public static function generateJoinMeetingParams(): array 'userId' => $faker->numberBetween(1, 1000), 'webVoiceConf' => $faker->word, 'creationTime' => $faker->unixTime, - 'role' => $faker->randomElement(Role::getValues()), + 'role' => self::randomEnumValues($faker, Role::class, 1), 'excludeFromDashboard' => $faker->boolean, 'userdata_countrycode' => $faker->countryCode, 'userdata_email' => $faker->email, @@ -269,7 +314,8 @@ public static function getCreateMeetingParametersMock(array $params): CreateMeet ->setLockSettingsDisableMic($params['lockSettingsDisableMic']) ->setLockSettingsDisablePrivateChat($params['lockSettingsDisablePrivateChat']) ->setLockSettingsDisablePublicChat($params['lockSettingsDisablePublicChat']) - ->setLockSettingsDisableNote($params['lockSettingsDisableNote']) + ->setLockSettingsDisableNote($params['lockSettingsDisableNotes']) + ->setLockSettingsDisableNotes($params['lockSettingsDisableNotes']) ->setLockSettingsHideUserList($params['lockSettingsHideUserList']) ->setLockSettingsLockedLayout($params['lockSettingsLockedLayout']) ->setLockSettingsLockOnJoin($params['lockSettingsLockOnJoin']) @@ -308,10 +354,7 @@ public static function getCreateMeetingParametersMock(array $params): CreateMeet ; } - /** - * @param mixed $params - */ - public static function getBreakoutCreateMock($params): CreateMeetingParameters + public static function getBreakoutCreateMock(mixed $params): CreateMeetingParameters { $createMeetingParams = Fixtures::getCreateMeetingParametersMock($params); diff --git a/tests/TestServices/ParamsIterator.php b/tests/TestServices/ParamsIterator.php index 233d8f84..49b7d373 100644 --- a/tests/TestServices/ParamsIterator.php +++ b/tests/TestServices/ParamsIterator.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -27,8 +27,6 @@ */ class ParamsIterator extends TestCase { - public function __construct() {} - /** * @param array $params */ @@ -39,6 +37,10 @@ public function iterate(array $params, string $url): void $value = $value ? 'true' : 'false'; } + if ($value instanceof \BackedEnum) { + $value = $value->value; + } + if (!is_array($value)) { $this->assertStringContainsString($value, urldecode($url)); } else { diff --git a/tests/Util/FixturesTest.php b/tests/Util/FixturesTest.php new file mode 100644 index 00000000..ae19ef1d --- /dev/null +++ b/tests/Util/FixturesTest.php @@ -0,0 +1,662 @@ +. + */ + +namespace BigBlueButton\Util; + +use BigBlueButton\BigBlueButton; +use BigBlueButton\Core\Hook; +use BigBlueButton\Enum\Role; +use BigBlueButton\Parameters\CreateMeetingParameters; +use BigBlueButton\Parameters\DeleteRecordingsParameters; +use BigBlueButton\Parameters\EndMeetingParameters; +use BigBlueButton\Parameters\GetMeetingInfoParameters; +use BigBlueButton\Parameters\GetRecordingsParameters; +use BigBlueButton\Parameters\HooksCreateParameters; +use BigBlueButton\Parameters\HooksDestroyParameters; +use BigBlueButton\Parameters\InsertDocumentParameters; +use BigBlueButton\Parameters\IsMeetingRunningParameters; +use BigBlueButton\Parameters\JoinMeetingParameters; +use BigBlueButton\Parameters\PublishRecordingsParameters; +use BigBlueButton\Parameters\SendChatMessageParameters; +use BigBlueButton\Parameters\UpdateRecordingsParameters; +use BigBlueButton\Responses\BaseResponse; +use BigBlueButton\TestServices\EnvLoader; +use BigBlueButton\TestServices\Fixtures; +use Faker\Factory as Faker; +use Faker\Generator; +use PHPUnit\Framework\TestCase; + +/** + * @internal + */ +class FixturesTest extends TestCase +{ + private BigBlueButton $bbb; + private Fixtures $fixtures; + + private static Generator $faker; + + public static function setUpBeforeClass(): void + { + self::$faker = Faker::create(); + } + + public function setUp(): void + { + parent::setUp(); + + EnvLoader::loadEnvironmentVariables(); + + $this->bbb = new BigBlueButton(); + $this->fixtures = new Fixtures(); + + // ensure server is clean (e.g. tearDown() has not been executed due to a previous failed tests) + $this->closeAllMeetings(); + $this->destroyAllHooks(); + } + + public function tearDown(): void + { + parent::tearDown(); + + $this->closeAllMeetings(); + $this->destroyAllHooks(); + } + + public function testCoverageOfFixtures(): void + { + // AS-IS: get all XML-file of the current test cases + $dataProvider = $this->xmlFileToFunctionMapping(); + $xmlFilenamesFromDataProvider = array_column($dataProvider, 'filename'); + + // TO-BE: get all XML-files of the fixtures-folder + $absolutePathNames = glob(Fixtures::RESPONSE_PATH . '*.xml'); + $this->assertIsArray($absolutePathNames); + $xmlFilenamesFromFolder = array_map(function($absolutePathname) { + return basename($absolutePathname); + }, $absolutePathNames); + $xmlFilesThatAreNotTestable = [ + 'hooks_destroy_failed_no_id.xml', // because: It is mandatory to have an id in the destroy constructor + 'hooks_destroy_failed_error.xml', // because: No idea how to simulate this on a well configured BBB-Server + 'hooks_create_failed_error.xml', // because: No idea how to simulate this on a well configured BBB-Server + ]; + $xmlFilenamesFromFolderCleaned = array_diff($xmlFilenamesFromFolder, $xmlFilesThatAreNotTestable); + + // COMPARE AS-IS AND TO-BE + $diff = array_diff($xmlFilenamesFromFolderCleaned, $xmlFilenamesFromDataProvider); + + if (!empty($diff)) { + self::markTestIncomplete("Not all XML-fixtures are checked regarding correctness:\n - " . implode("\n - ", $diff)); + } + } + + /** + * Background: A lot of the tests rely on the correctness of the data in the fixture files. If the fixture + * files are wrong the tests are not accurate. + * + * The purpose of this test is to determine whether the created fixture files still reflect accurately the + * response of the BBB-Server. It serves as an early indicator to determine if tests/functions need updates. + * + * @dataProvider xmlFileToFunctionMapping + */ + public function testStructureOfFixturesIsStillUpToDate(string $method, string $filename, bool $success, string $messageKey, ?\Closure $parameters): void + { + // get parameters by closure from data provider + $requestParameters = ($parameters) ? $parameters($this->bbb) : null; + + // make the request and get the XML of the response + /** @var BaseResponse $response */ + $response = $this->bbb->{$method}($requestParameters); + $xmlAsIs = $response->getRawXml(); + + // load the XML of the fixture + $xmlToBe = $this->fixtures->fromXmlFile($filename); + + $this->assertEquals($success, $response->success()); + $this->assertEquals($messageKey, $response->getMessageKey()); + $this->assertInstanceOf(\SimpleXMLElement::class, $xmlAsIs); + $this->assertInstanceOf(\SimpleXMLElement::class, $xmlToBe); + + /* + * There is a bug that prevents proper testing of the attendees. Once meetings are created on + * the server, you can join attendees, but by fetching the info of the meeting from the server + * the list of attendees is empty. So this needs to exclude temporary from the data that is + * coming from the fixture-files until that bug is solved. + * + * Remark: Once the bug is solved on the BBB-Server (= new Version), there must be a solution + * found to distinguish between versions prior and after the bug in order to keep the + * tests successful. + * + * @see https://github.com/bigbluebutton/bigbluebutton/issues/19767 + */ + if ( + 'get_meeting_info.xml' === $filename + || 'get_meeting_info_breakout_room.xml' === $filename + || 'get_meeting_info_with_breakout_rooms.xml' === $filename + ) { + unset($xmlToBe->attendees); // remove not empty node + $xmlToBe->addChild('attendees'); // add empty node + } + + $this->assertSameStructureOfXml($xmlToBe, $xmlAsIs); + } + + /** + * The data provider for the test above. + * + * @return array> + */ + public static function xmlFileToFunctionMapping(): array + { + return [ + 'case01_api_version' => [ + 'method' => 'getApiVersion', + 'filename' => 'api_version.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => null, + ], + 'case02_create_meeting' => [ + 'method' => 'createMeeting', + 'filename' => 'create_meeting.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): CreateMeetingParameters { + return new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room (case 02)'); + }, + ], + 'case03_join_meeting' => [ + 'method' => 'joinMeeting', + 'filename' => 'join_meeting.xml', + 'success' => true, + 'messageKey' => 'successfullyJoined', + 'parameters' => function(BigBlueButton $bbb): JoinMeetingParameters { + // arrange the BBB-server + $createMeetingParameters = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room (case 03)'); + $createMeetingResponse = $bbb->createMeeting($createMeetingParameters); + self::assertTrue($createMeetingResponse->success()); + self::assertEquals('bbb-none', $createMeetingResponse->getParentMeetingId()); + + // create and return parameter for test + $joinMeetingParameters = new JoinMeetingParameters($createMeetingResponse->getMeetingId(), self::$faker->name(), Role::VIEWER); + + return $joinMeetingParameters + ->setCreationTime($createMeetingResponse->getCreationTime()) + ->setUserId(self::$faker->uuid()) + ->setRedirect(false) + ; + }, + ], + 'case04_end_meeting' => [ + 'method' => 'endMeeting', + 'filename' => 'end_meeting.xml', + 'success' => true, + 'messageKey' => 'sentEndMeetingRequest', + 'parameters' => function(BigBlueButton $bbb): EndMeetingParameters { + // arrange the BBB-server + $createMeetingParameters = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room (case 04)'); + $createMeetingResponse = $bbb->createMeeting($createMeetingParameters); + self::assertTrue($createMeetingResponse->success()); + self::assertEquals('bbb-none', $createMeetingResponse->getParentMeetingId()); + + // create and return parameter for test + return new EndMeetingParameters($createMeetingResponse->getMeetingId()); + }, + ], + 'case05_is_meeting_running' => [ + 'method' => 'isMeetingRunning', + 'filename' => 'is_meeting_running.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): IsMeetingRunningParameters { + // arrange the BBB-server + $createMeetingParameters = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room (case 05)'); + $createMeetingResponse = $bbb->createMeeting($createMeetingParameters); + self::assertTrue($createMeetingResponse->success()); + self::assertEquals('bbb-none', $createMeetingResponse->getParentMeetingId()); + + // create and return parameter for test + return new IsMeetingRunningParameters($createMeetingResponse->getMeetingId()); + }, + ], + 'case06_list_of_meetings' => [ + 'method' => 'getMeetings', + 'filename' => 'get_meetings.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): void { + // create meeting room + $createMeetingParametersParent = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room 1 (case 06)'); + $createMeetingParametersParent + ->addMeta('endcallbackurl', self::$faker->url()) + ->addMeta('presenter', self::$faker->name()) + ; + $createMeetingResponseParent = $bbb->createMeeting($createMeetingParametersParent); + self::assertTrue($createMeetingResponseParent->success()); + self::assertEquals('bbb-none', $createMeetingResponseParent->getParentMeetingId()); + + // create breakout room + $createMeetingParametersChild = new CreateMeetingParameters(self::$faker->uuid(), 'Breakout Room (case 06)'); + $createMeetingParametersChild + ->addMeta('endcallbackurl', self::$faker->url()) + ->addMeta('presenter', self::$faker->name()) + ; + $createMeetingParametersChild->setParentMeetingId($createMeetingResponseParent->getMeetingId())->setBreakout(true)->setSequence(1); + $createMeetingResponseChild = $bbb->createMeeting($createMeetingParametersChild); + self::assertTrue($createMeetingResponseChild->success(), $createMeetingResponseChild->getMessage()); + self::assertEquals('', $createMeetingResponseChild->getMessage()); + self::assertNotEquals('bbb-none', $createMeetingResponseChild->getParentMeetingId()); + self::assertEquals($createMeetingResponseParent->getInternalMeetingId(), $createMeetingResponseChild->getParentMeetingId()); + }, + ], + 'case07_meeting_info_of_meeting_without_breakout_rooms' => [ + 'method' => 'getMeetingInfo', + 'filename' => 'get_meeting_info.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): GetMeetingInfoParameters { + // arrange the BBB-server + $createMeetingParameters = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room 1 (case 07)'); + $createMeetingParameters + ->addMeta('bbb-context', self::$faker->word()) + ->addMeta('bbb-origin-server-common-name', self::$faker->word()) + ->addMeta('bbb-origin-server-name', self::$faker->word()) + ->addMeta('bbb-origin-tag', self::$faker->word()) + ->addMeta('bbb-origin-version', self::$faker->word()) + ->addMeta('bbb-recording-description', self::$faker->word()) + ->addMeta('bbb-recording-name', self::$faker->word()) + ->addMeta('bbb-recording-tags', self::$faker->word()) + ->addMeta('bn-origin', self::$faker->word()) + ->addMeta('bn-recording-ready-url', self::$faker->word()) + ; + + $createMeetingResponse = $bbb->createMeeting($createMeetingParameters); + self::assertTrue($createMeetingResponse->success()); + self::assertEquals('bbb-none', $createMeetingResponse->getParentMeetingId()); + + // create and return parameter for test + return new GetMeetingInfoParameters($createMeetingResponse->getMeetingId()); + }, + ], + 'case08_meeting_info_of_breakout_room' => [ + 'method' => 'getMeetingInfo', + 'filename' => 'get_meeting_info_breakout_room.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): GetMeetingInfoParameters { + // create meeting room + $createMeetingParametersParent = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room 1 (case 08)'); + $createMeetingResponseParent = $bbb->createMeeting($createMeetingParametersParent); + self::assertTrue($createMeetingResponseParent->success()); + self::assertEquals('bbb-none', $createMeetingResponseParent->getParentMeetingId()); + + // create breakout room + $createMeetingParametersChild = new CreateMeetingParameters(self::$faker->uuid(), 'Breakout Room (case 08)'); + $createMeetingParametersChild + ->addMeta('bbb-context', self::$faker->word()) + ->setParentMeetingId($createMeetingResponseParent->getMeetingId()) + ->setBreakout(true) + ->setSequence(1) + ; + $createMeetingResponseChild = $bbb->createMeeting($createMeetingParametersChild); + self::assertTrue($createMeetingResponseChild->success(), $createMeetingResponseChild->getMessage()); + self::assertEquals('', $createMeetingResponseChild->getMessage()); + self::assertNotEquals('bbb-none', $createMeetingResponseChild->getParentMeetingId()); + self::assertEquals($createMeetingResponseParent->getInternalMeetingId(), $createMeetingResponseChild->getParentMeetingId()); + + // create and return parameter for test + return new GetMeetingInfoParameters($createMeetingResponseChild->getInternalMeetingId()); + }, + ], + 'case09_meeting_info_of_meeting_with_breakout_rooms' => [ + 'method' => 'getMeetingInfo', + 'filename' => 'get_meeting_info_with_breakout_rooms.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): GetMeetingInfoParameters { + // create meeting room + $createMeetingParametersParent = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room 1 (case 09)'); + $createMeetingParametersParent + ->addMeta('endcallbackurl', self::$faker->url()) + ->addMeta('presenter', self::$faker->name()) + ; + $createMeetingResponseParent = $bbb->createMeeting($createMeetingParametersParent); + self::assertTrue($createMeetingResponseParent->success()); + self::assertEquals('bbb-none', $createMeetingResponseParent->getParentMeetingId()); + + // create breakout room + $createMeetingParametersChild = new CreateMeetingParameters(self::$faker->uuid(), 'Breakout Room (case 09)'); + $createMeetingParametersChild + ->setParentMeetingId($createMeetingResponseParent->getMeetingId()) + ->setBreakout(true) + ->setSequence(1) + ; + $createMeetingResponseChild = $bbb->createMeeting($createMeetingParametersChild); + self::assertTrue($createMeetingResponseChild->success(), $createMeetingResponseChild->getMessage()); + self::assertEquals('', $createMeetingResponseChild->getMessage()); + self::assertNotEquals('bbb-none', $createMeetingResponseChild->getParentMeetingId()); + self::assertEquals($createMeetingResponseParent->getInternalMeetingId(), $createMeetingResponseChild->getParentMeetingId()); + + // create and return parameter for test + return new GetMeetingInfoParameters($createMeetingResponseParent->getMeetingId()); + }, + ], + 'case10_hooks_create' => [ + 'method' => 'hooksCreate', + 'filename' => 'hooks_create.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): HooksCreateParameters { + // create and return parameter for test + return new HooksCreateParameters(self::$faker->url()); + }, + ], + 'case11_hooks_create_existing' => [ + 'method' => 'hooksCreate', + 'filename' => 'hooks_create_existing.xml', + 'success' => true, + 'messageKey' => 'duplicateWarning', + 'parameters' => function(BigBlueButton $bbb): HooksCreateParameters { + $url = self::$faker->url(); + + // create hook + $hooksCreateParameters = new HooksCreateParameters($url); + $hooksCreateResponse = $bbb->hooksCreate($hooksCreateParameters); + self::assertTrue($hooksCreateResponse->success()); + + // create and return parameter for test + return new HooksCreateParameters($url); + }, + ], + 'case12_hooks_list' => [ + 'method' => 'hooksList', + 'filename' => 'hooks_list.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): void { + // create meeting + $createMeetingParameters = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room (case 12)'); + $createMeetingResponse = $bbb->createMeeting($createMeetingParameters); + self::assertTrue($createMeetingResponse->success()); + self::assertEquals('bbb-none', $createMeetingResponse->getParentMeetingId()); + + // create hook #1 (with meeting) + $hooksCreateParameters = new HooksCreateParameters(self::$faker->url()); + $hooksCreateParameters->setMeetingId($createMeetingResponse->getMeetingId()); + $hooksCreateResponse_2 = $bbb->hooksCreate($hooksCreateParameters); + self::assertTrue($hooksCreateResponse_2->success()); + + // create hook #2 (w/o meeting) + $hooksCreateParameters = new HooksCreateParameters(self::$faker->url()); + $hooksCreateResponse_1 = $bbb->hooksCreate($hooksCreateParameters); + self::assertTrue($hooksCreateResponse_1->success()); + }, + ], + 'case13_hooks_destroy' => [ + 'method' => 'hooksDestroy', + 'filename' => 'hooks_destroy.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): HooksDestroyParameters { + // create hook + $hooksCreateParameters = new HooksCreateParameters(self::$faker->url()); + $hooksCreateResponse = $bbb->hooksCreate($hooksCreateParameters); + self::assertTrue($hooksCreateResponse->success()); + self::assertIsString($hooksCreateResponse->getHookId()); + + // create and return parameter for test + return new HooksDestroyParameters($hooksCreateResponse->getHookId()); + }, + ], + 'case14_hooks_destroy_not_found' => [ + 'method' => 'hooksDestroy', + 'filename' => 'hooks_destroy_failed_not_found.xml', + 'success' => false, + 'messageKey' => 'destroyMissingHook', + 'parameters' => function(BigBlueButton $bbb): HooksDestroyParameters { + // create and return parameter for test + return new HooksDestroyParameters(self::$faker->numberBetween()); + }, + ], + 'case15_insert_document' => [ + 'method' => 'insertDocument', + 'filename' => 'insert_document.xml', + 'success' => true, + 'messageKey' => '', + 'parameters' => function(BigBlueButton $bbb): InsertDocumentParameters { + // arrange the BBB-server + $createMeetingParameters = new CreateMeetingParameters(self::$faker->uuid(), 'Meeting Room (case 05)'); + $createMeetingResponse = $bbb->createMeeting($createMeetingParameters); + self::assertTrue($createMeetingResponse->success()); + self::assertEquals('bbb-none', $createMeetingResponse->getParentMeetingId()); + + // create and return parameter for test + $insertDocumentParameters = new InsertDocumentParameters($createMeetingResponse->getMeetingId()); + + $insertDocumentParameters + ->addPresentation('https://freetestdata.com/wp-content/uploads/2021/09/Free_Test_Data_100KB_PDF.pdf') + ->addPresentation('https://freetestdata.com/wp-content/uploads/2022/02/Free_Test_Data_117KB_JPG.jpg') + ->addPresentation('https://freetestdata.com/wp-content/uploads/2021/09/500kb.png') + ->addPresentation('https://freetestdata.com/wp-content/uploads/2021/09/1.svg') + ; + + return $insertDocumentParameters; + }, + ], + 'case16_delete_recordings' => [ + 'method' => 'deleteRecordings', + 'filename' => 'delete_recordings_not_found.xml', + 'success' => false, + 'messageKey' => 'notFound', + 'parameters' => function(BigBlueButton $bbb): DeleteRecordingsParameters { + return new DeleteRecordingsParameters('test-recording-id-123'); + }, + ], + 'case17_get_recordings' => [ + 'method' => 'getRecordings', + 'filename' => 'get_recordings_no_recordings.xml', + 'success' => true, + 'messageKey' => 'noRecordings', + 'parameters' => function(BigBlueButton $bbb): GetRecordingsParameters { + return new GetRecordingsParameters(); + }, + ], + 'case18_get_recordings' => [ + 'method' => 'hooksDestroy', + 'filename' => 'hooks_destroy_failed_not_found.xml', + 'success' => false, + 'messageKey' => 'destroyMissingHook', + 'parameters' => function(BigBlueButton $bbb): HooksDestroyParameters { + return new HooksDestroyParameters('test-hook-id-456'); + }, + ], + 'case19_get_recordings' => [ + 'method' => 'publishRecordings', + 'filename' => 'publish_recordings_not_found.xml', + 'success' => false, + 'messageKey' => 'notFound', + 'parameters' => function(BigBlueButton $bbb): PublishRecordingsParameters { + return new PublishRecordingsParameters('test-recording-id-789', true); + }, + ], + 'case20_get_recordings' => [ + 'method' => 'sendChatMessage', + 'filename' => 'send_chat_message_failed.xml', + 'success' => false, + 'messageKey' => 'meetingNotFound', + 'parameters' => function(BigBlueButton $bbb): SendChatMessageParameters { + return new SendChatMessageParameters('test-meeting-id-123', 'Hello, this is a test message!'); + }, + ], + 'case21_get_recordings' => [ + 'method' => 'updateRecordings', + 'filename' => 'update_recordings_not_found.xml', + 'success' => false, + 'messageKey' => 'notFound', + 'parameters' => function(BigBlueButton $bbb): UpdateRecordingsParameters { + return new UpdateRecordingsParameters('test-recording-id-999'); + }, + ], + ]; + } + + private function closeAllMeetings(): void + { + $meetings = $this->bbb->getMeetings()->getMeetings(); + + foreach ($meetings as $meeting) { + $meetingId = $meeting->getInternalMeetingId(); + $endMeetingResponse = $this->bbb->endMeeting(new EndMeetingParameters($meetingId)); + self::assertEquals('SUCCESS', $endMeetingResponse->getReturnCode(), $endMeetingResponse->getMessage()); + self::assertTrue($endMeetingResponse->success()); + self::assertEquals('sentEndMeetingRequest', $endMeetingResponse->getMessageKey()); + } + + // ensure that no meetings exist anymore + self::assertEmpty($this->bbb->getMeetings()->getMeetings()); + } + + private function destroyAllHooks(): void + { + $hooks = $this->bbb->hooksList()->getHooks(); + + foreach ($hooks as $hook) { + self::assertInstanceOf(Hook::class, $hook); + $hookId = $hook->getHookId(); + $hooksDestroyResponse = $this->bbb->hooksDestroy(new HooksDestroyParameters($hookId)); + self::assertEquals('SUCCESS', $hooksDestroyResponse->getReturnCode(), $hooksDestroyResponse->getMessage()); + self::assertTrue($hooksDestroyResponse->success()); + self::assertEquals('', $hooksDestroyResponse->getMessageKey()); + } + + // ensure that no hooks exist anymore + self::assertEmpty($this->bbb->hooksList()->getHooks()); + } + + private function assertSameStructureOfXml(\SimpleXMLElement $xmlToBe, \SimpleXMLElement $xmlAsIs): void + { + $arrayToBe = $this->getStructureOfXmlAsArray($xmlToBe); + $arrayAsIs = $this->getStructureOfXmlAsArray($xmlAsIs); + + $expectedItemsMissingInResponse = array_diff($arrayToBe, $arrayAsIs); + $respondedItemsNotExpected = array_diff($arrayAsIs, $arrayToBe); + + $this->assertEqualsCanonicalizing( + $arrayToBe, + $arrayAsIs, + "Details:\n\n" + . 'Missing items in response: ' . implode('; ', $expectedItemsMissingInResponse) . "\n\n" + . 'Missing items in the file: ' . implode('; ', $respondedItemsNotExpected) . "\n\n" + ); + } + + /** + * Recursive function to flatten an array, which shall represent the structure of an + * element. For this, arrays that contain several children (= array with sequential + * numbers as keys) will get a list of unique attributes across all children. + * + * @param array $array + * + * @return array + */ + private function flattenArray(array $array, string $prefix = ''): array + { + $result = []; + + foreach ($array as $key => $value) { + $new_key = $prefix . (empty($prefix) ? '' : '.') . $key; + + // prepare value + if (is_array($value)) { + // a sequential array (= not associative) is understood as a group of + // similar children, thus their attributes should be similar. + if (!$this->isAssociativeArray($value)) { + // get a full collection of unique attributes within the group of children + $attributeCollection = []; + + foreach ($value as $child) { + if (!is_array($child)) { + continue; + } + + foreach ($child as $attributeKey => $attributeValue) { + if (!key_exists($attributeKey, $attributeCollection)) { + $attributeCollection[$attributeKey] = $attributeValue; + } + } + } + + $value = $attributeCollection; + } + } + + // compose result + if (is_array($value)) { + if (count($value) > 0) { + $result = array_merge($result, [$new_key => $value], $this->flattenArray($value, $new_key)); + } else { + $result[$new_key] = 'empty array'; // empty array + } + } else { + $result[$new_key] = $value; + } + } + + return $result; + } + + /** + * Function that helps to determine if an array is sequential or associative. + * + * Remark: With PHP 8.1 this function can be replaced by 'array_is_list'. + * + * @param array $array + */ + private function isAssociativeArray(array $array): bool + { + if (array_keys($array) === range(0, count($array) - 1)) { + return false; + } + + return true; + } + + /** + * @return array + */ + private function getStructureOfXmlAsArray(\SimpleXMLElement $xml): array + { + // transform XML to ARRAY (via JSON) + $json = json_encode($xml); + self::assertIsString($json); + $array = json_decode($json, true); + + // flatten multidimensional array to string-based hierarchy + $flattenArray = $this->flattenArray($array); + + // only the keys are needed + $keys = array_keys($flattenArray); + + // bring the key into alphabetic order + sort($keys); + + return $keys; + } +} diff --git a/tests/Util/UrlBuilderTest.php b/tests/Util/UrlBuilderTest.php index c32d8301..0bf92cb3 100644 --- a/tests/Util/UrlBuilderTest.php +++ b/tests/Util/UrlBuilderTest.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software @@ -89,7 +89,7 @@ public function testCreateMeetingUrl(): void $params = $this->generateCreateParams(); $url = $this->urlBuilder->getCreateMeetingUrl($this->getCreateMock($params)); - $paramsIterator = new ParamsIterator(); + $paramsIterator = new ParamsIterator('testCreateMeetingUrl'); $paramsIterator->iterate($params, $url); } @@ -100,7 +100,7 @@ public function testCreateJoinMeetingUrl(): void $joinMeetingMock = $this->getJoinMeetingMock($joinMeetingParams); $url = $this->urlBuilder->getJoinMeetingURL($joinMeetingMock); - $paramsIterator = new ParamsIterator(); + $paramsIterator = new ParamsIterator('testCreateJoinMeetingUrl'); $paramsIterator->iterate($joinMeetingParams, $url); } @@ -108,7 +108,7 @@ public function testCreateEndMeetingUrl(): void { $params = $this->generateEndMeetingParams(); $url = $this->urlBuilder->getEndMeetingURL($this->getEndMeetingMock($params)); - $paramsIterator = new ParamsIterator(); + $paramsIterator = new ParamsIterator('testCreateEndMeetingUrl'); $paramsIterator->iterate($params, $url); } @@ -148,7 +148,7 @@ public function testUpdateRecordingsUrl(): void { $params = Fixtures::generateUpdateRecordingsParams(); $url = $this->urlBuilder->getUpdateRecordingsUrl(Fixtures::getUpdateRecordingsParamsMock($params)); - $paramsIterator = new ParamsIterator(); + $paramsIterator = new ParamsIterator('testUpdateRecordingsUrl'); $paramsIterator->iterate($params, $url); } } diff --git a/tests/bootstrap.php b/tests/bootstrap.php index 868bb4ab..bad01ede 100644 --- a/tests/bootstrap.php +++ b/tests/bootstrap.php @@ -3,7 +3,7 @@ /* * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/. * - * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below). + * Copyright (c) 2016-2026 BigBlueButton Inc. and by respective authors (see below). * * This program is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free Software diff --git a/tests/fixtures/api_version.xml b/tests/fixtures/api_version.xml deleted file mode 100644 index e7551901..00000000 --- a/tests/fixtures/api_version.xml +++ /dev/null @@ -1,6 +0,0 @@ - - SUCCESS - 2.0 - 2.0 - 2.4-rc-7 - diff --git a/tests/fixtures/hooks_destroy_params_no_id.xml b/tests/fixtures/hooks_destroy_params_no_id.xml deleted file mode 100644 index 297fed8d..00000000 --- a/tests/fixtures/hooks_destroy_params_no_id.xml +++ /dev/null @@ -1,5 +0,0 @@ - - FAILED - missingParamHookID - You must specify a hookID in the parameters. - \ No newline at end of file diff --git a/tests/fixtures/bbb_logo.png b/tests/fixtures/images/bbb_logo.png similarity index 100% rename from tests/fixtures/bbb_logo.png rename to tests/fixtures/images/bbb_logo.png diff --git a/tests/fixtures/insert_document_case_1.xml b/tests/fixtures/insert_document_case_1.xml new file mode 100644 index 00000000..2cbe2f32 --- /dev/null +++ b/tests/fixtures/insert_document_case_1.xml @@ -0,0 +1,6 @@ + + + + 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 + + \ No newline at end of file diff --git a/tests/fixtures/insert_document_case_2.xml b/tests/fixtures/insert_document_case_2.xml new file mode 100644 index 00000000..ad93b6cf --- /dev/null +++ b/tests/fixtures/insert_document_case_2.xml @@ -0,0 +1,6 @@ + + + + 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 + + \ No newline at end of file diff --git a/tests/fixtures/insert_document_case_3.xml b/tests/fixtures/insert_document_case_3.xml new file mode 100644 index 00000000..e0001bf9 --- /dev/null +++ b/tests/fixtures/insert_document_case_3.xml @@ -0,0 +1,6 @@ + + + + + + diff --git a/tests/fixtures/insert_document_presentations.xml b/tests/fixtures/insert_document_presentations.xml deleted file mode 100644 index 997ecaf5..00000000 --- a/tests/fixtures/insert_document_presentations.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - - - diff --git a/tests/fixtures/insert_document_presentations_with_filenames.xml b/tests/fixtures/insert_document_presentations_with_filenames.xml new file mode 100644 index 00000000..c92f5a16 --- /dev/null +++ b/tests/fixtures/insert_document_presentations_with_filenames.xml @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/tests/fixtures/insert_document_presentations_with_filenames_and_options.xml b/tests/fixtures/insert_document_presentations_with_filenames_and_options.xml new file mode 100644 index 00000000..87126b9b --- /dev/null +++ b/tests/fixtures/insert_document_presentations_with_filenames_and_options.xml @@ -0,0 +1,6 @@ + + + + + + diff --git a/tests/fixtures/presentation_with_filename.xml b/tests/fixtures/presentation_with_filename.xml deleted file mode 100644 index 2b346089..00000000 --- a/tests/fixtures/presentation_with_filename.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - diff --git a/tests/fixtures/requests/insert_document_presentations.xml b/tests/fixtures/requests/insert_document_presentations.xml new file mode 100644 index 00000000..1edfb949 --- /dev/null +++ b/tests/fixtures/requests/insert_document_presentations.xml @@ -0,0 +1,9 @@ + + + + + + + + + diff --git a/tests/fixtures/requests/insert_document_presentations_with_options.xml b/tests/fixtures/requests/insert_document_presentations_with_options.xml new file mode 100644 index 00000000..14453a77 --- /dev/null +++ b/tests/fixtures/requests/insert_document_presentations_with_options.xml @@ -0,0 +1,6 @@ + + + + + + diff --git a/tests/fixtures/presentation_with_embedded_file.xml b/tests/fixtures/requests/presentation_with_embedded_file.xml similarity index 100% rename from tests/fixtures/presentation_with_embedded_file.xml rename to tests/fixtures/requests/presentation_with_embedded_file.xml diff --git a/tests/fixtures/requests/presentation_with_file.xml b/tests/fixtures/requests/presentation_with_file.xml new file mode 100644 index 00000000..cbd817a7 --- /dev/null +++ b/tests/fixtures/requests/presentation_with_file.xml @@ -0,0 +1,6 @@ + + + + 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 + + diff --git a/tests/fixtures/requests/presentation_with_filename.xml b/tests/fixtures/requests/presentation_with_filename.xml new file mode 100644 index 00000000..aeb1b6b1 --- /dev/null +++ b/tests/fixtures/requests/presentation_with_filename.xml @@ -0,0 +1,6 @@ + + + + + + diff --git a/tests/fixtures/presentation_with_url.xml b/tests/fixtures/requests/presentation_with_url.xml similarity index 50% rename from tests/fixtures/presentation_with_url.xml rename to tests/fixtures/requests/presentation_with_url.xml index cf45ce3a..d7603085 100644 --- a/tests/fixtures/presentation_with_url.xml +++ b/tests/fixtures/requests/presentation_with_url.xml @@ -1,6 +1,6 @@ - + diff --git a/tests/fixtures/responses/api_version.xml b/tests/fixtures/responses/api_version.xml new file mode 100644 index 00000000..a33f52e0 --- /dev/null +++ b/tests/fixtures/responses/api_version.xml @@ -0,0 +1,9 @@ + + SUCCESS + 2.0 + 2.0 + 3.0.19 + 0.0.95 + wss://bigbluebutton.server.com/graphql + https://bigbluebutton.server.com/api/rest + diff --git a/tests/fixtures/create_meeting.xml b/tests/fixtures/responses/create_meeting.xml similarity index 100% rename from tests/fixtures/create_meeting.xml rename to tests/fixtures/responses/create_meeting.xml diff --git a/tests/fixtures/delete_recordings.xml b/tests/fixtures/responses/delete_recordings.xml similarity index 100% rename from tests/fixtures/delete_recordings.xml rename to tests/fixtures/responses/delete_recordings.xml diff --git a/tests/fixtures/responses/delete_recordings_not_found.xml b/tests/fixtures/responses/delete_recordings_not_found.xml new file mode 100644 index 00000000..e83287a1 --- /dev/null +++ b/tests/fixtures/responses/delete_recordings_not_found.xml @@ -0,0 +1,5 @@ + + FAILED + notFound + Could not find recording + diff --git a/tests/fixtures/end_meeting.xml b/tests/fixtures/responses/end_meeting.xml similarity index 100% rename from tests/fixtures/end_meeting.xml rename to tests/fixtures/responses/end_meeting.xml diff --git a/tests/fixtures/responses/feedback_response.json b/tests/fixtures/responses/feedback_response.json new file mode 100644 index 00000000..e0d32821 --- /dev/null +++ b/tests/fixtures/responses/feedback_response.json @@ -0,0 +1,12 @@ +{ + "status": "ok", + "feedback_id": "feedback-123456", + "session_token": "session-token-789", + "meeting_id": "meeting456", + "user_id": "user123", + "rating": 4, + "comment": "Great meeting experience!", + "submitted_at": "2023-01-15T14:30:00Z", + "processed": true, + "feedback_type": "meeting_feedback" +} \ No newline at end of file diff --git a/tests/fixtures/get_meeting_info.xml b/tests/fixtures/responses/get_meeting_info.xml similarity index 94% rename from tests/fixtures/get_meeting_info.xml rename to tests/fixtures/responses/get_meeting_info.xml index f3e4e219..86d8ba66 100644 --- a/tests/fixtures/get_meeting_info.xml +++ b/tests/fixtures/responses/get_meeting_info.xml @@ -73,9 +73,7 @@ - true - b97b512f2c92c0ffe7a3476152525807daa1c676-1524213151782 - 1 + false Best BBB Developers Club Moodle @@ -90,6 +88,4 @@ Bigbluebutton "Mock meeting for testing getMeetingInfo" - - \ No newline at end of file diff --git a/tests/fixtures/responses/get_meeting_info_breakout_room.xml b/tests/fixtures/responses/get_meeting_info_breakout_room.xml new file mode 100644 index 00000000..743d4ccc --- /dev/null +++ b/tests/fixtures/responses/get_meeting_info_breakout_room.xml @@ -0,0 +1,83 @@ + + + SUCCESS + Mock meeting for testing getMeetingInfo API method + 117b12ae2656972d330b6bad58878541-28-15 + 178757fcedd9449054536162cdfe861ddebc70ba-1453206317376 + 1453206317376 + Tue Jan 19 07:25:17 EST 2016 + 70100 + 613-555-1234 + dbfc7207321527bbb870c82028 + 4bfbbeeb4a65cacaefe3676633 + true + 20 + true + true + false + 1453206317380 + 1453206325002 + 2 + 1 + 2 + 1 + 20 + 2 + + + amslzbgzzddp + Ernie Abernathy + MODERATOR + true + false + true + true + HTML5 + + + + xi7y7gpmyq1g + Barrett Kutch + MODERATOR + false + false + true + false + FLASH + + true + #FF0033 + a:focus{color:#0181eb} + + + + srfd2uad4x9s + Peter Parker + VIEWER + false + false + true + true + HTML5 + + + + 6ntb564ibhnq + Bruce Wayne + VIEWER + false + true + false + false + HTML5 + + + + true + ParentMeetingId + 1 + false + + Best BBB Developers Club + + \ No newline at end of file diff --git a/tests/fixtures/responses/get_meeting_info_with_breakout_rooms.xml b/tests/fixtures/responses/get_meeting_info_with_breakout_rooms.xml new file mode 100644 index 00000000..8a076f4a --- /dev/null +++ b/tests/fixtures/responses/get_meeting_info_with_breakout_rooms.xml @@ -0,0 +1,86 @@ + + + SUCCESS + Mock meeting for testing getMeetingInfo API method + 117b12ae2656972d330b6bad58878541-28-15 + 178757fcedd9449054536162cdfe861ddebc70ba-1453206317376 + 1453206317376 + Tue Jan 19 07:25:17 EST 2016 + 70100 + 613-555-1234 + dbfc7207321527bbb870c82028 + 4bfbbeeb4a65cacaefe3676633 + true + 20 + true + true + false + 1453206317380 + 1453206325002 + 2 + 1 + 2 + 1 + 20 + 2 + + + amslzbgzzddp + Ernie Abernathy + MODERATOR + true + false + true + true + HTML5 + + + + xi7y7gpmyq1g + Barrett Kutch + MODERATOR + false + false + true + false + FLASH + + true + #FF0033 + a:focus{color:#0181eb} + + + + srfd2uad4x9s + Peter Parker + VIEWER + false + false + true + true + HTML5 + + + + 6ntb564ibhnq + Bruce Wayne + VIEWER + false + true + false + false + HTML5 + + + + false + + breakout-room-id-1 + breakout-room-id-2 + breakout-room-id-3 + + + Prof. Maud Corkery II + http://www.hegmann.biz/explicabo-praesentium-labore-dolor + + \ No newline at end of file diff --git a/tests/fixtures/get_meetings.xml b/tests/fixtures/responses/get_meetings.xml similarity index 91% rename from tests/fixtures/get_meetings.xml rename to tests/fixtures/responses/get_meetings.xml index 39a8afe4..adde2a46 100644 --- a/tests/fixtures/get_meetings.xml +++ b/tests/fixtures/responses/get_meetings.xml @@ -61,7 +61,10 @@ Prof. Maud Corkery II http://www.hegmann.biz/explicabo-praesentium-labore-dolor - false + true + ParentMeetingId + 1 + false Marty Lueilwitz @@ -93,6 +96,11 @@ http://www.muller.biz/autem-dolor-aut-nam-doloribus-molestiae false + + breakout-room-id-1 + breakout-room-id-2 + breakout-room-id-3 + \ No newline at end of file diff --git a/tests/fixtures/get_recording_text_tracks.json b/tests/fixtures/responses/get_recording_text_tracks.json similarity index 100% rename from tests/fixtures/get_recording_text_tracks.json rename to tests/fixtures/responses/get_recording_text_tracks.json diff --git a/tests/fixtures/get_recordings.xml b/tests/fixtures/responses/get_recordings.xml similarity index 90% rename from tests/fixtures/get_recordings.xml rename to tests/fixtures/responses/get_recordings.xml index 1a3c9bf1..f5eac879 100644 --- a/tests/fixtures/get_recordings.xml +++ b/tests/fixtures/responses/get_recordings.xml @@ -30,7 +30,7 @@ presentation - http://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462807897120 + https://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462807897120 2973 532 168019 @@ -93,7 +93,7 @@ presentation - http://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1463067444315 + https://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1463067444315 63 @@ -120,7 +120,7 @@ presentation - http://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1463413631320 + https://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1463413631320 50 @@ -128,11 +128,14 @@ f71d810b6e90a4a34ae02b8c7143e8733178578e-1462980100026 9d287cf50490ca856ca5273bd303a7e321df6051-4-119[0] + f71d810b6e90a4a34ae02b8c7143e8733178578e-1462980100026 true published 1462980100026 1462986640649 + 6 + 7219530 @@ -148,7 +151,7 @@ presentation - http://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462980100026 + https://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462980100026 86 @@ -175,7 +178,7 @@ presentation - http://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462894360422 + https://test-install.blindsidenetworks.com/playback/presentation/0.9.0/playback.html?meetingId=f71d810b6e90a4a34ae02b8c7143e8733178578e-1462894360422 46 diff --git a/tests/fixtures/responses/get_recordings_no_recordings.xml b/tests/fixtures/responses/get_recordings_no_recordings.xml new file mode 100644 index 00000000..e63bd970 --- /dev/null +++ b/tests/fixtures/responses/get_recordings_no_recordings.xml @@ -0,0 +1,6 @@ + + SUCCESS + noRecordings + No recordings found + + diff --git a/tests/fixtures/hooks_create.xml b/tests/fixtures/responses/hooks_create.xml similarity index 100% rename from tests/fixtures/hooks_create.xml rename to tests/fixtures/responses/hooks_create.xml diff --git a/tests/fixtures/hooks_create_existing.xml b/tests/fixtures/responses/hooks_create_existing.xml similarity index 100% rename from tests/fixtures/hooks_create_existing.xml rename to tests/fixtures/responses/hooks_create_existing.xml diff --git a/tests/fixtures/hooks_create_error.xml b/tests/fixtures/responses/hooks_create_failed_error.xml similarity index 100% rename from tests/fixtures/hooks_create_error.xml rename to tests/fixtures/responses/hooks_create_failed_error.xml diff --git a/tests/fixtures/hooks_destroy.xml b/tests/fixtures/responses/hooks_destroy.xml similarity index 100% rename from tests/fixtures/hooks_destroy.xml rename to tests/fixtures/responses/hooks_destroy.xml diff --git a/tests/fixtures/hooks_destroy_error.xml b/tests/fixtures/responses/hooks_destroy_failed_error.xml similarity index 100% rename from tests/fixtures/hooks_destroy_error.xml rename to tests/fixtures/responses/hooks_destroy_failed_error.xml diff --git a/tests/fixtures/hooks_create_no_hook_id.xml b/tests/fixtures/responses/hooks_destroy_failed_no_id.xml similarity index 100% rename from tests/fixtures/hooks_create_no_hook_id.xml rename to tests/fixtures/responses/hooks_destroy_failed_no_id.xml diff --git a/tests/fixtures/hooks_destroy_not_found.xml b/tests/fixtures/responses/hooks_destroy_failed_not_found.xml similarity index 100% rename from tests/fixtures/hooks_destroy_not_found.xml rename to tests/fixtures/responses/hooks_destroy_failed_not_found.xml diff --git a/tests/fixtures/hooks_list.xml b/tests/fixtures/responses/hooks_list.xml similarity index 96% rename from tests/fixtures/hooks_list.xml rename to tests/fixtures/responses/hooks_list.xml index 9e8fc9b8..0d15e68a 100644 --- a/tests/fixtures/hooks_list.xml +++ b/tests/fixtures/responses/hooks_list.xml @@ -6,6 +6,7 @@ false + false diff --git a/tests/fixtures/insert_document.xml b/tests/fixtures/responses/insert_document.xml similarity index 100% rename from tests/fixtures/insert_document.xml rename to tests/fixtures/responses/insert_document.xml diff --git a/tests/fixtures/is_meeting_running.xml b/tests/fixtures/responses/is_meeting_running.xml similarity index 100% rename from tests/fixtures/is_meeting_running.xml rename to tests/fixtures/responses/is_meeting_running.xml diff --git a/tests/fixtures/join_meeting.xml b/tests/fixtures/responses/join_meeting.xml similarity index 100% rename from tests/fixtures/join_meeting.xml rename to tests/fixtures/responses/join_meeting.xml diff --git a/tests/fixtures/publish_recordings.xml b/tests/fixtures/responses/publish_recordings.xml similarity index 100% rename from tests/fixtures/publish_recordings.xml rename to tests/fixtures/responses/publish_recordings.xml diff --git a/tests/fixtures/responses/publish_recordings_not_found.xml b/tests/fixtures/responses/publish_recordings_not_found.xml new file mode 100644 index 00000000..e83287a1 --- /dev/null +++ b/tests/fixtures/responses/publish_recordings_not_found.xml @@ -0,0 +1,5 @@ + + FAILED + notFound + Could not find recording + diff --git a/tests/fixtures/put_recording_text_track_success.json b/tests/fixtures/responses/put_recording_text_track_success.json similarity index 100% rename from tests/fixtures/put_recording_text_track_success.json rename to tests/fixtures/responses/put_recording_text_track_success.json diff --git a/tests/fixtures/responses/send_chat_message.xml b/tests/fixtures/responses/send_chat_message.xml new file mode 100644 index 00000000..0d24a770 --- /dev/null +++ b/tests/fixtures/responses/send_chat_message.xml @@ -0,0 +1,5 @@ + + SUCCESS + + + diff --git a/tests/fixtures/responses/send_chat_message_failed.xml b/tests/fixtures/responses/send_chat_message_failed.xml new file mode 100644 index 00000000..884152cd --- /dev/null +++ b/tests/fixtures/responses/send_chat_message_failed.xml @@ -0,0 +1,5 @@ + + FAILED + meetingNotFound + Meeting not found or not active + diff --git a/tests/fixtures/update_recordings.xml b/tests/fixtures/responses/update_recordings.xml similarity index 100% rename from tests/fixtures/update_recordings.xml rename to tests/fixtures/responses/update_recordings.xml diff --git a/tests/fixtures/responses/update_recordings_not_found.xml b/tests/fixtures/responses/update_recordings_not_found.xml new file mode 100644 index 00000000..e83287a1 --- /dev/null +++ b/tests/fixtures/responses/update_recordings_not_found.xml @@ -0,0 +1,5 @@ + + FAILED + notFound + Could not find recording +