First initial

andrey-helldar · andrey-helldar · commit 38ddd254165f · 2025-10-21T22:13:20.000+03:00
diff --git a/.editorconfig b/.editorconfig
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,12 @@
+* text=auto
+
+.github/ export-ignore
+tests/ export-ignore
+
+.editorconfig export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+
+pint.json export-ignore
+
+phpunit.xml export-ignore
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,64 @@
+name: Bug Report
+description: Report an Issue or Bug with the Telemetry Package
+labels: [ "bug" ]
+
+body:
+    -   type: markdown
+        attributes:
+            value: |
+                We're sorry to hear you have a problem. Can you help us solve it by providing the following details.
+    -   type: textarea
+        id: what-happened
+        attributes:
+            label: What Happened
+            description: What did you expect to happen?
+        validations:
+            required: true
+    -   type: textarea
+        id: how-to-reproduce
+        attributes:
+            label: How to Reproduce
+            description: How did this occur, please add any config values used and provide a set of reliable steps if possible.
+            placeholder: Install a fresh app, attach Requests middleware, ...
+        validations:
+            required: true
+    -   type: input
+        id: feed-version
+        attributes:
+            label: Telemetry Version
+            description: What version of our Package are you running? Please be as specific as possible
+            placeholder: 1.0.0
+        validations:
+            required: true
+    -   type: input
+        id: php-version
+        attributes:
+            label: PHP Version
+            description: What version of PHP are you running? Please be as specific as possible
+            placeholder: 8.4.12
+        validations:
+            required: true
+    -   type: dropdown
+        id: operating-systems
+        attributes:
+            label: Operation System
+            description: On which operating systems does the problem occur? You can select more than one.
+            multiple: true
+            options:
+                - macOS
+                - Windows
+                - Linux
+        validations:
+            required: true
+    -   type: textarea
+        id: notes
+        attributes:
+            label: Notes
+            description: Use this field to provide any other notes that you feel might be relevant to the issue.
+        validations:
+            required: false
+
+    -   type: markdown
+        attributes:
+            value: |
+                ❤️ The Dragon Code? Please consider supporting [`our collective`](https://boosty.to/dragon-code).
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1 @@
+blank_issues_enabled: false
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,20 @@
+name: Feature Proposal
+description: Propose a new feature
+labels: [ "feature" ]
+
+body:
+    -   type: textarea
+        id: description
+        attributes:
+            label: Feature description
+            description: |
+                Think through your proposal and describe it clearly.
+
+                Note that features are only added to the most recent version of Laravel Lang.
+        validations:
+            required: true
+
+    -   type: markdown
+        attributes:
+            value: |
+                ❤️ The Dragon Code? Please consider supporting [`our collective`](https://boosty.to/dragon-code).
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,16 @@
+<!--
+- Fill in the form below correctly. This will help the Pest team to understand the PR and also work on it.
+-->
+
+### What:
+
+- [ ] Bug Fix
+- [ ] New Feature
+
+### Description:
+
+<!-- describe what your PR is solving -->
+
+### Related:
+
+<!-- link to the issue(s) your PR is solving. If it doesn't exist, remove the "Related" section. -->
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -0,0 +1,9 @@
+version: 2
+updates:
+    -
+        package-ecosystem: github-actions
+        directory: /
+        schedule:
+            interval: daily
+        labels:
+            - dependabot
diff --git a/.github/workflows/code-style.yml b/.github/workflows/code-style.yml
@@ -0,0 +1,12 @@
+name: Code Style
+
+on:
+    push:
+
+permissions: write-all
+
+jobs:
+    Checks:
+        uses: TheDragonCode/.github/.github/workflows/code-style.yml@main
+        with:
+            node: false
diff --git a/.github/workflows/license.yml b/.github/workflows/license.yml
@@ -0,0 +1,10 @@
+name: Update license
+
+on:
+    schedule:
+        -   cron: '0 3 1 1 *'
+    workflow_dispatch:
+
+jobs:
+    Update:
+        uses: TheDragonCode/.github/.github/workflows/license.yml@main
diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
@@ -0,0 +1,11 @@
+name: Release Drafter
+
+on:
+    push:
+        branches:
+            - main
+    workflow_dispatch:
+
+jobs:
+    Update:
+        uses: TheDragonCode/.github/.github/workflows/release-drafter.yml@main
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -0,0 +1,76 @@
+name: Tests
+
+on:
+    push:
+
+jobs:
+    unit:
+        runs-on: ubuntu-latest
+
+        strategy:
+            fail-fast: true
+            matrix:
+                php: [ "8.2", "8.3", "8.4" ]
+
+        name: PHP ${{ matrix.php }}
+
+        steps:
+            -   name: Checkout code
+                uses: actions/checkout@v5
+
+            -   name: Setup PHP
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    extensions: curl, mbstring, zip, pcntl, pdo, pdo_sqlite, iconv
+                    coverage: xdebug
+
+            -   name: Install dependencies
+                run: composer update
+
+            -   name: Execute tests
+                run: composer test
+
+    type_coverage:
+        runs-on: ubuntu-latest
+
+        name: Type Coverage
+
+        steps:
+            -   name: Checkout code
+                uses: actions/checkout@v5
+
+            -   name: Setup PHP
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    extensions: curl, mbstring, zip, pcntl, pdo, pdo_sqlite, iconv
+                    coverage: xdebug
+
+            -   name: Install dependencies
+                run: composer update
+
+            -   name: Execute tests
+                run: composer test:type
+
+    coverage:
+        runs-on: ubuntu-latest
+
+        name: Coverage
+
+        steps:
+            -   name: Checkout code
+                uses: actions/checkout@v5
+
+            -   name: Setup PHP
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    extensions: curl, mbstring, zip, pcntl, pdo, pdo_sqlite, iconv
+                    coverage: xdebug
+
+            -   name: Install dependencies
+                run: composer update
+
+            -   name: Execute tests
+                run: composer test:coverage
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,16 @@
+.cursor/
+.idea/
+.junie/
+.vscode/
+
+vendor/
+
+.cache
+.DS_Store
+
+*.bak
+*.cache
+*.clover
+*.orig
+
+composer.lock
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Andrey Helldar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
@@ -0,0 +1,74 @@
+# 🪢 Telemetry
+
+![the dragon code telemetry](https://preview.dragon-code.pro/the%20dragon%20code/telemetry.svg?brand=php&mode=auto)
+
+[![Stable Version][badge_stable]][link_packagist]
+[![Total Downloads][badge_downloads]][link_packagist]
+[![License][badge_license]][link_license]
+
+End-to-end telemetry of inter-service communication.
+
+## Installation
+
+You can install the **Telemetry** package via [Composer](https://getcomposer.org):
+
+```Bash
+composer require dragon-code/telemetry
+```
+
+## Basic Usage
+
+### Using Default Header Names
+
+```php
+use DragonCode\Telemetry\TelemetryHeader;
+use DragonCode\Telemetry\TelemetryRequest;
+use Symfony\Component\HttpFoundation\Request;
+
+/** @var Request $request */
+$request = /* ... */;
+
+$telemetry = new TelemetryRequest($request, new TelemetryHeader);
+
+function telemetry(Request $request, ?int $userId = null): Request
+{
+    return (new TelemetryRequest($request, new TelemetryHeader))
+        ->userId($userId)
+        ->ip()
+        ->trackId()
+        ->getRequest();
+}
+
+// Для первого вызова
+telemetry($request, $user->id);
+
+// Для последующих сервисов
+telemetry($request);
+```
+
+### Custom Header Names
+
+```php
+use DragonCode\Telemetry\TelemetryHeader;
+
+return new TelemetryHeader(
+    userId: 'Some-User-Id',
+    ip: 'Some-IP',
+    trackId: 'Some-Track-Id',
+);
+```
+
+## License
+
+This package is licensed under the [MIT License](LICENSE).
+
+
+[badge_downloads]:      https://img.shields.io/packagist/dt/dragon-code/telemetry.svg?style=flat-square
+
+[badge_license]:        https://img.shields.io/packagist/l/dragon-code/telemetry.svg?style=flat-square
+
+[badge_stable]:         https://img.shields.io/github/v/release/TheDragonCode/telemetry?label=packagist&style=flat-square
+
+[link_license]:         LICENSE
+
+[link_packagist]:       https://packagist.org/packages/dragon-code/telemetry
diff --git a/composer.json b/composer.json
diff --git a/phpunit.xml b/phpunit.xml
diff --git a/src/TelemetryHeader.php b/src/TelemetryHeader.php
diff --git a/src/TelemetryRequest.php b/src/TelemetryRequest.php
diff --git a/tests/Pest.php b/tests/Pest.php
