create-berna-stencil 1.0.8 → 1.0.10

package/src/api/vendor/graham-campbell/result-type/src/Success.php

@@ -0,0 +1,120 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of Result Type.
+ *
+ * (c) Graham Campbell <hello@gjcampbell.co.uk>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace GrahamCampbell\ResultType;
+
+use PhpOption\None;
+use PhpOption\Some;
+
+/**
+ * @template T
+ * @template E
+ *
+ * @extends \GrahamCampbell\ResultType\Result<T,E>
+ */
+final class Success extends Result
+{
+    /**
+     * @var T
+     */
+    private $value;
+
+    /**
+     * Internal constructor for a success value.
+     *
+     * @param T $value
+     *
+     * @return void
+     */
+    private function __construct($value)
+    {
+        $this->value = $value;
+    }
+
+    /**
+     * Create a new error value.
+     *
+     * @template S
+     *
+     * @param S $value
+     *
+     * @return \GrahamCampbell\ResultType\Result<S,E>
+     */
+    public static function create($value)
+    {
+        return new self($value);
+    }
+
+    /**
+     * Get the success option value.
+     *
+     * @return \PhpOption\Option<T>
+     */
+    public function success()
+    {
+        return Some::create($this->value);
+    }
+
+    /**
+     * Map over the success value.
+     *
+     * @template S
+     *
+     * @param callable(T):S $f
+     *
+     * @return \GrahamCampbell\ResultType\Result<S,E>
+     */
+    public function map(callable $f)
+    {
+        return self::create($f($this->value));
+    }
+
+    /**
+     * Flat map over the success value.
+     *
+     * @template S
+     * @template F
+     *
+     * @param callable(T):\GrahamCampbell\ResultType\Result<S,F> $f
+     *
+     * @return \GrahamCampbell\ResultType\Result<S,F>
+     */
+    public function flatMap(callable $f)
+    {
+        return $f($this->value);
+    }
+
+    /**
+     * Get the error option value.
+     *
+     * @return \PhpOption\Option<E>
+     */
+    public function error()
+    {
+        return None::create();
+    }
+
+    /**
+     * Map over the error value.
+     *
+     * @template F
+     *
+     * @param callable(E):F $f
+     *
+     * @return \GrahamCampbell\ResultType\Result<T,F>
+     */
+    public function mapError(callable $f)
+    {
+        return self::create($this->value);
+    }
+}

package/src/api/vendor/graham-campbell/result-type/tests/ResultTest.php

@@ -0,0 +1,95 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of Result Type.
+ *
+ * (c) Graham Campbell <hello@gjcampbell.co.uk>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace GrahamCampbell\Tests\ResultType;
+
+use GrahamCampbell\ResultType\Error;
+use GrahamCampbell\ResultType\Success;
+use PHPUnit\Framework\TestCase;
+use RuntimeException;
+
+class ResultTest extends TestCase
+{
+    public function testSuccessValue(): void
+    {
+        self::assertTrue(Success::create('foo')->error()->isEmpty());
+        self::assertTrue(Success::create('foo')->success()->isDefined());
+        self::assertSame('foo', Success::create('foo')->success()->get());
+    }
+
+    public function testSuccessMapping(): void
+    {
+        $r = Success::create('foo')
+            ->map('strtoupper')
+            ->mapError('ucfirst');
+
+        self::assertTrue($r->success()->isDefined());
+        self::assertSame('FOO', $r->success()->get());
+    }
+
+    public function testSuccessFlatMappingSuccess(): void
+    {
+        $r = Success::create('foo')->flatMap(function (string $data): Success {
+            return Success::create('OH YES');
+        });
+
+        self::assertTrue($r->success()->isDefined());
+        self::assertSame('OH YES', $r->success()->get());
+    }
+
+    public function testSuccessFlatMappingError(): void
+    {
+        $r = Success::create('foo')->flatMap(function (string $data): Error {
+            return Error::create('OH NO');
+        });
+
+        self::assertTrue($r->error()->isDefined());
+        self::assertSame('OH NO', $r->error()->get());
+    }
+
+    public function testSuccessFail(): void
+    {
+        $result = Success::create('foo');
+
+        $this->expectException(RuntimeException::class);
+        $this->expectExceptionMessage('None has no value.');
+
+        $result->error()->get();
+    }
+
+    public function testErrorValue(): void
+    {
+        self::assertTrue(Error::create('foo')->error()->isDefined());
+        self::assertTrue(Error::create('foo')->success()->isEmpty());
+        self::assertSame('foo', Error::create('foo')->error()->get());
+    }
+
+    public function testErrorMapping(): void
+    {
+        $r = Error::create('foo')
+            ->map('strtoupper')
+            ->mapError('ucfirst');
+
+        self::assertSame('Foo', $r->error()->get());
+    }
+
+    public function testErrorFail(): void
+    {
+        $result = Error::create('foo');
+
+        $this->expectException(RuntimeException::class);
+        $this->expectExceptionMessage('None has no value.');
+
+        $result->success()->get();
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/.codecov.yml

@@ -0,0 +1,21 @@
+codecov:
+  notify:
+    after_n_builds: 2
+
+coverage:
+  round: nearest
+  # Status will be green when coverage is between 70 and 100%.
+  range: "70...100"
+  status:
+    project:
+      default:
+        threshold: 2%
+        paths:
+          - "src"
+    patch:
+      default:
+        threshold: 0%
+        paths:
+          - "src"
+
+comment: false

package/src/api/vendor/phpmailer/phpmailer/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+indent_size = 4
+indent_style = space
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2

package/src/api/vendor/phpmailer/phpmailer/.gitattributes

@@ -0,0 +1,17 @@
+* text=auto
+
+/.codecov.yml export-ignore
+/.editorconfig export-ignore
+/.gitattributes export-ignore
+/.github export-ignore
+/.gitignore export-ignore
+/.phan export-ignore
+/.scrutinizer.yml export-ignore
+/changelog.md export-ignore
+/docs export-ignore
+/examples export-ignore
+/phpcs.xml.dist export-ignore
+/phpdoc.dist.xml export-ignore
+/phpunit.xml.dist export-ignore
+/test export-ignore
+/UPGRADING.md export-ignore

package/src/api/vendor/phpmailer/phpmailer/.github/FUNDING.yml

@@ -0,0 +1,6 @@
+# These are supported funding model platforms
+
+github: Synchro
+patreon: marcusbointon
+tidelift: "packagist/phpmailer/phpmailer"
+custom: https://marcus.bointon.com/donations/

package/src/api/vendor/phpmailer/phpmailer/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: If you've found a bug in PHPMailer, this is the right place to report it
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+Please check these things before submitting your issue:
+
+- [ ] *Read the error message* you're seeing - it often tells you what is wrong, and may contain useful links & instructions
+- [ ] Make sure you're using the latest version of PHPMailer
+- [ ] Check that your problem is not dealt with in [the troubleshooting guide](https://github.com/PHPMailer/PHPMailer/wiki/Troubleshooting), especially if you're having problems connecting to Gmail or GoDaddy
+- [ ] Include sufficient code to reproduce your problem
+- [ ] If you're having an SMTP issue, include the debug output generated with `SMTPDebug = 2` set
+- [ ] If you have a question about how to use PHPMailer (rather than reporting a bug in it), tag a question on Stack Overflow with `phpmailer`, but [**search first**](https://stackoverflow.com/questions/tagged/phpmailer)!
+
+# Problem description
+
+# Code to reproduce
+
+# Debug output

package/src/api/vendor/phpmailer/phpmailer/.github/actions/build-docs/Dockerfile

@@ -0,0 +1,15 @@
+FROM phpdoc/phpdoc
+
+LABEL "repository"="https://github.com/PHPMailer/PHPMailer"
+
+LABEL "com.github.actions.name"="Build Docs"
+LABEL "com.github.actions.description"="Build Docs with phpDocumentor"
+LABEL "com.github.actions.icon"="file-text"
+LABEL "com.github.actions.color"="blue"
+
+# don't show errors
+RUN echo "display_errors = Off" > $PHP_INI_DIR/conf.d/errors.ini
+
+COPY entrypoint.sh /entrypoint.sh
+
+ENTRYPOINT ["/entrypoint.sh"]

package/src/api/vendor/phpmailer/phpmailer/.github/actions/build-docs/entrypoint.sh

@@ -0,0 +1,5 @@
+#!/bin/sh
+
+set -eu
+
+/opt/phpdoc/bin/phpdoc

package/src/api/vendor/phpmailer/phpmailer/.github/dependabot.yml

@@ -0,0 +1,21 @@
+# Dependabot configuration.
+#
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "cron"
+      cronjob: "10 22 5,20 * *" # At 22:10, every 5th and 20th day of the month.
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "GH Actions:"
+    groups:
+      action-runners:
+        applies-to: version-updates
+        update-types:
+          - "minor"
+          - "patch"

package/src/api/vendor/phpmailer/phpmailer/.github/workflows/docs.yaml

@@ -0,0 +1,30 @@
+name: Docs
+on:
+  push:
+    branches:
+      - master
+permissions: {}
+jobs:
+  build_and_publish:
+    permissions:
+      contents: write # to push changes in repo (jamesives/github-pages-deploy-action)
+
+    name: Build and publish Docs
+    runs-on: ubuntu-latest
+    if: github.repository == 'PHPMailer/PHPMailer'
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          fetch-depth: 1
+          persist-credentials: false
+      - name: Build Docs
+        uses: ./.github/actions/build-docs
+      - name: Publish Docs to gh-pages
+        uses: JamesIves/github-pages-deploy-action@9d877eea73427180ae43cf98e8914934fe157a1a # v4.7.6
+        with:
+          branch: gh-pages
+          folder: docs
+        env:
+          BUILD_DIR: docs/
+          GH_PAT: ${{ secrets.GH_PAT }}

package/src/api/vendor/phpmailer/phpmailer/.github/workflows/scorecards.yml

@@ -0,0 +1,61 @@
+name: Scorecards supply-chain security
+on:
+  # Only the default branch is supported.
+  branch_protection_rule:
+  schedule:
+    - cron: '39 20 * * 1'
+  push:
+    branches: [ "master" ]
+
+permissions: {}
+
+jobs:
+  analysis:
+    # Don't run the cron job on forks.
+    if: ${{ github.event_name != 'schedule' || github.event.repository.fork == false }}
+
+    name: Scorecards analysis
+    runs-on: ubuntu-latest
+
+    permissions:
+      # Required when publishing results (badge / API / code scanning)
+      security-events: write
+      id-token: write
+
+    steps:
+      - name: "Checkout code"
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          persist-credentials: false
+
+      - name: "Run analysis"
+        uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3
+        with:
+          results_file: results.sarif
+          results_format: sarif
+          # (Optional) Read-only PAT token. Uncomment the `repo_token` line below if:
+          # - you want to enable the Branch-Protection check on a *public* repository, or
+          # - you are installing Scorecards on a *private* repository
+          # To create the PAT, follow the steps in https://github.com/ossf/scorecard-action#authentication-with-pat.
+          # repo_token: ${{ secrets.SCORECARD_READ_TOKEN }}
+
+          # Publish the results for public repositories to enable scorecard badges. For more details, see
+          # https://github.com/ossf/scorecard-action#publishing-results. 
+          # For private repositories, `publish_results` will automatically be set to `false`, regardless 
+          # of the value entered here.
+          publish_results: true
+
+      # Upload the results as artifacts (optional). Commenting out will disable uploads of run results in SARIF
+      # format to the repository Actions tab.
+      - name: "Upload artifact"
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
+        with:
+          name: SARIF file
+          path: results.sarif
+          retention-days: 5
+      
+      # Upload the results to GitHub's code scanning dashboard.
+      - name: "Upload to code-scanning"
+        uses: github/codeql-action/upload-sarif@5d4e8d1aca955e8d8589aabd499c5cae939e33c7 # v4.31.9
+        with:
+          sarif_file: results.sarif

package/src/api/vendor/phpmailer/phpmailer/.github/workflows/tests.yml

@@ -0,0 +1,237 @@
+name: "Tests"
+
+on:
+  push:
+  pull_request:
+  # Allow manually triggering the workflow.
+  workflow_dispatch:
+
+permissions: {}
+
+jobs:
+
+  coding-standard:
+    runs-on: ubuntu-22.04
+    name: Coding standards
+
+    permissions:
+      contents: read # to fetch code (actions/checkout)
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          persist-credentials: false
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@44454db4f0199b8b9685a5d763dc37cbf79108e1 # 2.36.0
+        with:
+          php-version: 'latest'
+          coverage: none
+          tools: cs2pr
+
+      # Install dependencies and handle caching in one go.
+      # @link https://github.com/marketplace/actions/install-php-dependencies-with-composer
+      - name: Install Composer dependencies
+        uses: "ramsey/composer-install@3cf229dc2919194e9e36783941438d17239e8520" # 3.1.1
+        with:
+          # Bust the cache at least once a month - output format: YYYY-MM.
+          custom-cache-suffix: $(date -u "+%Y-%m")
+
+      - name: Check coding standards
+        id: phpcs
+        run: ./vendor/bin/phpcs -s --report-full --report-checkstyle=./phpcs-report.xml
+
+      - name: Show PHPCS results in PR
+        if: ${{ always() && steps.phpcs.outcome == 'failure' }}
+        run: cs2pr ./phpcs-report.xml
+
+  lint:
+    runs-on: ubuntu-22.04
+    strategy:
+      matrix:
+        php: ['5.5', '7.2', '8.0', '8.5']
+        experimental: [false]
+        include:
+          - php: 'nightly'
+            experimental: true
+
+    name: "Lint: PHP ${{ matrix.php }}"
+    continue-on-error: ${{ matrix.experimental }}
+
+    permissions:
+      contents: read # to fetch code (actions/checkout)
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          persist-credentials: false
+
+      - name: Install PHP
+        uses: shivammathur/setup-php@44454db4f0199b8b9685a5d763dc37cbf79108e1 # 2.36.0
+        with:
+          php-version: ${{ matrix.php }}
+          ini-values: error_reporting=-1, display_errors=On, display_startup_errors=On
+          coverage: none
+          tools: cs2pr
+
+      # Install dependencies and handle caching in one go.
+      # @link https://github.com/marketplace/actions/install-php-dependencies-with-composer
+      - name: Install Composer dependencies
+        uses: "ramsey/composer-install@3cf229dc2919194e9e36783941438d17239e8520" # 3.1.1
+        with:
+          # Bust the cache at least once a month - output format: YYYY-MM.
+          custom-cache-suffix: $(date -u "+%Y-%m")
+
+      - name: Lint against parse errors
+        if: ${{ matrix.php != 'nightly' }}
+        run: composer lint -- --checkstyle | cs2pr
+
+      - name: Lint against future parse errors (PHP nightly)
+        if: ${{ matrix.php == 'nightly' }}
+        run: composer lint
+
+  test:
+    needs: ['coding-standard', 'lint']
+    runs-on: ubuntu-22.04
+    strategy:
+      matrix:
+        php: ['5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3', '8.4']
+        extensions: ['optimal', 'minimal']
+        coverage: [false]
+        experimental: [false]
+        include:
+          # Run code coverage on high/low PHP.
+          - php: '5.5'
+            extensions: 'optimal'
+            coverage: true
+            experimental: false
+          - php: '5.5'
+            extensions: 'minimal'
+            coverage: true
+            experimental: false
+          - php: '8.5'
+            extensions: 'optimal'
+            coverage: true
+            experimental: false
+          - php: '8.5'
+            extensions: 'minimal'
+            coverage: true
+            experimental: false
+
+          # Experimental builds. These are allowed to fail.
+          - php: '8.6'
+            extensions: 'optimal'
+            coverage: false
+            experimental: true
+          - php: '8.6'
+            extensions: 'minimal'
+            coverage: false
+            experimental: true
+
+    name: "Test: PHP ${{ matrix.php }} - ${{ matrix.extensions }}"
+
+    continue-on-error: ${{ matrix.experimental }}
+
+    permissions:
+      contents: read # to fetch code (actions/checkout)
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          persist-credentials: false
+
+        # About the "extensions":
+        #
+        # In a "normal" test run, the "default" extension set for a PHP version is used
+        # and it is ensured that certain extensions will be available, no matter what.
+        #
+        # For the "minimal" test run, all extensions are disabled and then only
+        # a limited set of minimally required extensions are re-enabled.
+        # The minimal set is based on the required extensions from PHPUnit + PHPMailer combined
+        # + Curl for Composer.
+        # Whether Xdebug will be enabled depends on the code coverage settings.
+        #
+        # Also see:
+        # https://github.com/shivammathur/setup-php/?tab=readme-ov-file#heavy_plus_sign-php-extension-support
+        # https://github.com/shivammathur/setup-php/wiki
+      - name: Determine extensions to use
+        id: set_extensions
+        run: |
+          if [[ "${{ matrix.extensions }}" == "optimal" ]]; then
+            # Optimal.
+            echo 'EXT=imap, mbstring, openssl, intl, ctype, filter, hash' >> $GITHUB_OUTPUT
+            echo 'COMPOSER_OPTIONS=' >> $GITHUB_OUTPUT
+          else
+            # Minimal.
+            echo 'EXT=none, curl, dom, json, libxml, mbstring, tokenizer, xml, xmlwriter, ctype, filter, hash' >> $GITHUB_OUTPUT
+            echo 'COMPOSER_OPTIONS=--ignore-platform-req=ext-simplexml' >> $GITHUB_OUTPUT
+          fi
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@44454db4f0199b8b9685a5d763dc37cbf79108e1 # 2.36.0
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: ${{ matrix.coverage && 'xdebug' || 'none' }}
+          ini-values: sendmail_path=/usr/sbin/sendmail -t -i, error_reporting=-1, display_errors=On, display_startup_errors=On
+          extensions: ${{ steps.set_extensions.outputs.EXT }}
+
+      # Install dependencies and handle caching in one go.
+      # @link https://github.com/marketplace/actions/install-php-dependencies-with-composer
+      - name: Install PHP packages - normal
+        if: ${{ matrix.php != '8.6' }}
+        uses: "ramsey/composer-install@3cf229dc2919194e9e36783941438d17239e8520" # 3.1.1
+        with:
+          composer-options: ${{ steps.set_extensions.outputs.COMPOSER_OPTIONS }}
+          # Bust the cache at least once a month - output format: YYYY-MM.
+          custom-cache-suffix: $(date -u "+%Y-%m")
+
+      - name: Install PHP packages - ignore-platform-reqs
+        if: ${{ matrix.php == '8.6' }}
+        uses: "ramsey/composer-install@3cf229dc2919194e9e36783941438d17239e8520" # 3.1.1
+        with:
+          composer-options: --ignore-platform-reqs ${{ steps.set_extensions.outputs.COMPOSER_OPTIONS }}
+          # Bust the cache at least once a month - output format: YYYY-MM.
+          custom-cache-suffix: $(date -u "+%Y-%m")
+
+      # Install postfix and automatically retry if the install failed, which happens reguarly.
+      # @link https://github.com/marketplace/actions/retry-step
+      - name: Install postfix
+        uses: nick-invision/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3.0.2
+        with:
+          timeout_minutes: 2
+          max_attempts: 3
+          retry_wait_seconds: 8
+          command: |
+            sudo apt-get install --fix-broken -y libsqlite3-0 postfix
+            sudo systemctl stop postfix.service
+
+      - name: Set up sendmail
+        run: |
+          smtp-sink -d "%d.%H.%M.%S" localhost:2500 1000 &
+          mkdir -p build/logs
+          sudo cp test/testbootstrap-dist.php test/testbootstrap.php
+          sudo chmod +x test/fakesendmail.sh
+          sudo mkdir -p /var/qmail/bin
+          sudo cp test/fakesendmail.sh /var/qmail/bin/sendmail
+          sudo cp test/fakesendmail.sh /usr/sbin/sendmail
+
+      - name: Run tests, no code coverage
+        if: ${{ matrix.coverage == false }}
+        run: ./vendor/bin/phpunit --no-coverage
+
+      - name: Run tests with code coverage
+        if: ${{ matrix.coverage == true }}
+        run: vendor/bin/phpunit
+
+      - name: Send coverage report to Codecov
+        if: ${{ success() && matrix.coverage == true && github.event.repository.fork == false }}
+        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5.5.2
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+        with:
+          files: ./build/logs/clover.xml
+          fail_ci_if_error: true
+          verbose: true