pax_global_header00006660000000000000000000000064151413153670014520gustar00rootroot0000000000000052 comment=dac5b0bc00c32f5a1bb4bcc545692d129b4c34ce php-core-1.3.0/000077500000000000000000000000001514131536700132365ustar00rootroot00000000000000php-core-1.3.0/.gitignore000066400000000000000000000000151514131536700152220ustar00rootroot00000000000000.idea vendor php-core-1.3.0/README.md000066400000000000000000000070761514131536700145270ustar00rootroot00000000000000![SharpAPI GitHub cover](https://sharpapi.com/sharpapi-github-laravel-bg.jpg "SharpAPI Laravel Client") # SharpAPI.com PHP Core functionalities & communication ## 🚀 Automate workflows with AI-powered API ### Leverage AI API to streamline workflows in E-Commerce, Marketing, Content Management, HR Tech, Travel, and more. See more at [SharpAPI.com Website »](https://sharpapi.com/) --- ## Quota Method The `quota()` method returns a `SubscriptionInfo` DTO with the following fields: | Field | Type | Description | |---|---|---| | `timestamp` | `Carbon` | Timestamp of the subscription check | | `on_trial` | `bool` | Whether the account is on a trial period | | `trial_ends` | `Carbon` | End date of the trial period | | `subscribed` | `bool` | Whether the user is currently subscribed | | `current_subscription_start` | `Carbon` | Start of the current subscription period | | `current_subscription_end` | `Carbon` | End of the current subscription period | | `current_subscription_reset` | `Carbon` | Quota reset timestamp | | `subscription_words_quota` | `int` | Total word quota for the period | | `subscription_words_used` | `int` | Words used in the current period | | `subscription_words_used_percentage` | `float` | Percentage of word quota used | | `requests_per_minute` | `int` | Maximum API requests allowed per minute | ```php $client = new SharpApiClient('your-api-key'); $quota = $client->quota(); echo $quota->subscription_words_quota; echo $quota->requests_per_minute; ``` --- ## Rate Limiting The SDK automatically handles API rate limits. When the API returns HTTP 429 (Too Many Requests), the client will: 1. **Retry automatically** — reads the `Retry-After` header, sleeps for the specified duration, and retries the request (up to 3 times by default). 2. **Slow down polling** — during `fetchResults()`, when `X-RateLimit-Remaining` drops below the low threshold, polling intervals are automatically increased to avoid hitting the limit. ### Inspecting Rate-Limit State After any API call, you can check the current rate-limit values: ```php $client = new SharpApiClient('your-api-key'); $client->ping(); echo $client->getRateLimitLimit(); // e.g. 60 (requests per window) echo $client->getRateLimitRemaining(); // e.g. 58 (remaining in current window) ``` > **Note:** `getRateLimitLimit()` and `getRateLimitRemaining()` return `null` before the first API call or after endpoints that don't return rate-limit headers (e.g. `/ping`, `/quota`). ### Configuration ```php // Max automatic retries on HTTP 429 (default: 3) $client->setMaxRetryOnRateLimit(5); // Threshold below which polling intervals are increased (default: 3) $client->setRateLimitLowThreshold(5); ``` When `rateLimitRemaining` is at or below the threshold, polling intervals in `fetchResults()` are multiplied by an increasing factor (2x at threshold, growing as remaining approaches 0). This helps avoid 429 errors during long-running job polling. --- ## Credits - [A2Z WEB LTD](https://github.com/a2zwebltd) - [Dawid Makowski](https://github.com/makowskid) - Boost your [Laravel AI](https://sharpapi.com/) capabilities! --- ## License The MIT License (MIT). --- ## Social Media 🚀 For the latest news, tutorials, and case studies, don't forget to follow us on: - [SharpAPI X (formerly Twitter)](https://x.com/SharpAPI) - [SharpAPI YouTube](https://www.youtube.com/@SharpAPI) - [SharpAPI Vimeo](https://vimeo.com/SharpAPI) - [SharpAPI LinkedIn](https://www.linkedin.com/products/a2z-web-ltd-sharpapicom-automate-with-aipowered-api/) - [SharpAPI Facebook](https://www.facebook.com/profile.php?id=61554115896974) php-core-1.3.0/composer.json000066400000000000000000000013121514131536700157550ustar00rootroot00000000000000{ "name": "sharpapi/php-core", "description": "SharpAPI.com PHP Core functionalities & communication", "type": "library", "require": { "php": "^8.1", "guzzlehttp/guzzle": "^7.8.2", "nesbot/carbon": "^2.0|^3.0", "ext-json": "*", "ext-mbstring": "*", "spatie/url": "^2.4" }, "license": "MIT", "autoload": { "psr-4": { "SharpAPI\\Core\\": "src/" } }, "authors": [ { "name": "Dawid Makowski", "email": "contact@sharpapi.com" } ], "extra": { "branch-alias": { "dev-master": "1.3.x-dev" } }, "minimum-stability": "stable" } php-core-1.3.0/composer.lock000066400000000000000000001357551514131536700157570ustar00rootroot00000000000000{ "_readme": [ "This file locks the dependencies of your project to a known state", "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], "content-hash": "eceac5399d0864d7eaa0cd3109fad000", "packages": [ { "name": "carbonphp/carbon-doctrine-types", "version": "3.2.0", "source": { "type": "git", "url": "https://github.com/CarbonPHP/carbon-doctrine-types.git", "reference": "18ba5ddfec8976260ead6e866180bd5d2f71aa1d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/CarbonPHP/carbon-doctrine-types/zipball/18ba5ddfec8976260ead6e866180bd5d2f71aa1d", "reference": "18ba5ddfec8976260ead6e866180bd5d2f71aa1d", "shasum": "" }, "require": { "php": "^8.1" }, "conflict": { "doctrine/dbal": "<4.0.0 || >=5.0.0" }, "require-dev": { "doctrine/dbal": "^4.0.0", "nesbot/carbon": "^2.71.0 || ^3.0.0", "phpunit/phpunit": "^10.3" }, "type": "library", "autoload": { "psr-4": { "Carbon\\Doctrine\\": "src/Carbon/Doctrine/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "KyleKatarn", "email": "kylekatarnls@gmail.com" } ], "description": "Types to use Carbon in Doctrine", "keywords": [ "carbon", "date", "datetime", "doctrine", "time" ], "support": { "issues": "https://github.com/CarbonPHP/carbon-doctrine-types/issues", "source": "https://github.com/CarbonPHP/carbon-doctrine-types/tree/3.2.0" }, "funding": [ { "url": "https://github.com/kylekatarnls", "type": "github" }, { "url": "https://opencollective.com/Carbon", "type": "open_collective" }, { "url": "https://tidelift.com/funding/github/packagist/nesbot/carbon", "type": "tidelift" } ], "time": "2024-02-09T16:56:22+00:00" }, { "name": "guzzlehttp/guzzle", "version": "7.9.3", "source": { "type": "git", "url": "https://github.com/guzzle/guzzle.git", "reference": "7b2f29fe81dc4da0ca0ea7d42107a0845946ea77" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/guzzle/guzzle/zipball/7b2f29fe81dc4da0ca0ea7d42107a0845946ea77", "reference": "7b2f29fe81dc4da0ca0ea7d42107a0845946ea77", "shasum": "" }, "require": { "ext-json": "*", "guzzlehttp/promises": "^1.5.3 || ^2.0.3", "guzzlehttp/psr7": "^2.7.0", "php": "^7.2.5 || ^8.0", "psr/http-client": "^1.0", "symfony/deprecation-contracts": "^2.2 || ^3.0" }, "provide": { "psr/http-client-implementation": "1.0" }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", "ext-curl": "*", "guzzle/client-integration-tests": "3.0.2", "php-http/message-factory": "^1.1", "phpunit/phpunit": "^8.5.39 || ^9.6.20", "psr/log": "^1.1 || ^2.0 || ^3.0" }, "suggest": { "ext-curl": "Required for CURL handler support", "ext-intl": "Required for Internationalized Domain Name (IDN) support", "psr/log": "Required for using the Log middleware" }, "type": "library", "extra": { "bamarni-bin": { "bin-links": true, "forward-command": false } }, "autoload": { "files": [ "src/functions_include.php" ], "psr-4": { "GuzzleHttp\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Graham Campbell", "email": "hello@gjcampbell.co.uk", "homepage": "https://github.com/GrahamCampbell" }, { "name": "Michael Dowling", "email": "mtdowling@gmail.com", "homepage": "https://github.com/mtdowling" }, { "name": "Jeremy Lindblom", "email": "jeremeamia@gmail.com", "homepage": "https://github.com/jeremeamia" }, { "name": "George Mponos", "email": "gmponos@gmail.com", "homepage": "https://github.com/gmponos" }, { "name": "Tobias Nyholm", "email": "tobias.nyholm@gmail.com", "homepage": "https://github.com/Nyholm" }, { "name": "Márk Sági-Kazár", "email": "mark.sagikazar@gmail.com", "homepage": "https://github.com/sagikazarmark" }, { "name": "Tobias Schultze", "email": "webmaster@tubo-world.de", "homepage": "https://github.com/Tobion" } ], "description": "Guzzle is a PHP HTTP client library", "keywords": [ "client", "curl", "framework", "http", "http client", "psr-18", "psr-7", "rest", "web service" ], "support": { "issues": "https://github.com/guzzle/guzzle/issues", "source": "https://github.com/guzzle/guzzle/tree/7.9.3" }, "funding": [ { "url": "https://github.com/GrahamCampbell", "type": "github" }, { "url": "https://github.com/Nyholm", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/guzzle", "type": "tidelift" } ], "time": "2025-03-27T13:37:11+00:00" }, { "name": "guzzlehttp/promises", "version": "2.2.0", "source": { "type": "git", "url": "https://github.com/guzzle/promises.git", "reference": "7c69f28996b0a6920945dd20b3857e499d9ca96c" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/guzzle/promises/zipball/7c69f28996b0a6920945dd20b3857e499d9ca96c", "reference": "7c69f28996b0a6920945dd20b3857e499d9ca96c", "shasum": "" }, "require": { "php": "^7.2.5 || ^8.0" }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", "phpunit/phpunit": "^8.5.39 || ^9.6.20" }, "type": "library", "extra": { "bamarni-bin": { "bin-links": true, "forward-command": false } }, "autoload": { "psr-4": { "GuzzleHttp\\Promise\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Graham Campbell", "email": "hello@gjcampbell.co.uk", "homepage": "https://github.com/GrahamCampbell" }, { "name": "Michael Dowling", "email": "mtdowling@gmail.com", "homepage": "https://github.com/mtdowling" }, { "name": "Tobias Nyholm", "email": "tobias.nyholm@gmail.com", "homepage": "https://github.com/Nyholm" }, { "name": "Tobias Schultze", "email": "webmaster@tubo-world.de", "homepage": "https://github.com/Tobion" } ], "description": "Guzzle promises library", "keywords": [ "promise" ], "support": { "issues": "https://github.com/guzzle/promises/issues", "source": "https://github.com/guzzle/promises/tree/2.2.0" }, "funding": [ { "url": "https://github.com/GrahamCampbell", "type": "github" }, { "url": "https://github.com/Nyholm", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/promises", "type": "tidelift" } ], "time": "2025-03-27T13:27:01+00:00" }, { "name": "guzzlehttp/psr7", "version": "2.7.1", "source": { "type": "git", "url": "https://github.com/guzzle/psr7.git", "reference": "c2270caaabe631b3b44c85f99e5a04bbb8060d16" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/guzzle/psr7/zipball/c2270caaabe631b3b44c85f99e5a04bbb8060d16", "reference": "c2270caaabe631b3b44c85f99e5a04bbb8060d16", "shasum": "" }, "require": { "php": "^7.2.5 || ^8.0", "psr/http-factory": "^1.0", "psr/http-message": "^1.1 || ^2.0", "ralouphie/getallheaders": "^3.0" }, "provide": { "psr/http-factory-implementation": "1.0", "psr/http-message-implementation": "1.0" }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", "http-interop/http-factory-tests": "0.9.0", "phpunit/phpunit": "^8.5.39 || ^9.6.20" }, "suggest": { "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses" }, "type": "library", "extra": { "bamarni-bin": { "bin-links": true, "forward-command": false } }, "autoload": { "psr-4": { "GuzzleHttp\\Psr7\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Graham Campbell", "email": "hello@gjcampbell.co.uk", "homepage": "https://github.com/GrahamCampbell" }, { "name": "Michael Dowling", "email": "mtdowling@gmail.com", "homepage": "https://github.com/mtdowling" }, { "name": "George Mponos", "email": "gmponos@gmail.com", "homepage": "https://github.com/gmponos" }, { "name": "Tobias Nyholm", "email": "tobias.nyholm@gmail.com", "homepage": "https://github.com/Nyholm" }, { "name": "Márk Sági-Kazár", "email": "mark.sagikazar@gmail.com", "homepage": "https://github.com/sagikazarmark" }, { "name": "Tobias Schultze", "email": "webmaster@tubo-world.de", "homepage": "https://github.com/Tobion" }, { "name": "Márk Sági-Kazár", "email": "mark.sagikazar@gmail.com", "homepage": "https://sagikazarmark.hu" } ], "description": "PSR-7 message implementation that also provides common utility methods", "keywords": [ "http", "message", "psr-7", "request", "response", "stream", "uri", "url" ], "support": { "issues": "https://github.com/guzzle/psr7/issues", "source": "https://github.com/guzzle/psr7/tree/2.7.1" }, "funding": [ { "url": "https://github.com/GrahamCampbell", "type": "github" }, { "url": "https://github.com/Nyholm", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/psr7", "type": "tidelift" } ], "time": "2025-03-27T12:30:47+00:00" }, { "name": "nesbot/carbon", "version": "3.9.0", "source": { "type": "git", "url": "https://github.com/CarbonPHP/carbon.git", "reference": "6d16a8a015166fe54e22c042e0805c5363aef50d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/CarbonPHP/carbon/zipball/6d16a8a015166fe54e22c042e0805c5363aef50d", "reference": "6d16a8a015166fe54e22c042e0805c5363aef50d", "shasum": "" }, "require": { "carbonphp/carbon-doctrine-types": "<100.0", "ext-json": "*", "php": "^8.1", "psr/clock": "^1.0", "symfony/clock": "^6.3 || ^7.0", "symfony/polyfill-mbstring": "^1.0", "symfony/translation": "^4.4.18 || ^5.2.1|| ^6.0 || ^7.0" }, "provide": { "psr/clock-implementation": "1.0" }, "require-dev": { "doctrine/dbal": "^3.6.3 || ^4.0", "doctrine/orm": "^2.15.2 || ^3.0", "friendsofphp/php-cs-fixer": "^3.57.2", "kylekatarnls/multi-tester": "^2.5.3", "ondrejmirtes/better-reflection": "^6.25.0.4", "phpmd/phpmd": "^2.15.0", "phpstan/extension-installer": "^1.3.1", "phpstan/phpstan": "^1.11.2", "phpunit/phpunit": "^10.5.20", "squizlabs/php_codesniffer": "^3.9.0" }, "bin": [ "bin/carbon" ], "type": "library", "extra": { "laravel": { "providers": [ "Carbon\\Laravel\\ServiceProvider" ] }, "phpstan": { "includes": [ "extension.neon" ] }, "branch-alias": { "dev-2.x": "2.x-dev", "dev-master": "3.x-dev" } }, "autoload": { "psr-4": { "Carbon\\": "src/Carbon/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Brian Nesbitt", "email": "brian@nesbot.com", "homepage": "https://markido.com" }, { "name": "kylekatarnls", "homepage": "https://github.com/kylekatarnls" } ], "description": "An API extension for DateTime that supports 281 different languages.", "homepage": "https://carbon.nesbot.com", "keywords": [ "date", "datetime", "time" ], "support": { "docs": "https://carbon.nesbot.com/docs", "issues": "https://github.com/CarbonPHP/carbon/issues", "source": "https://github.com/CarbonPHP/carbon" }, "funding": [ { "url": "https://github.com/sponsors/kylekatarnls", "type": "github" }, { "url": "https://opencollective.com/Carbon#sponsor", "type": "opencollective" }, { "url": "https://tidelift.com/subscription/pkg/packagist-nesbot-carbon?utm_source=packagist-nesbot-carbon&utm_medium=referral&utm_campaign=readme", "type": "tidelift" } ], "time": "2025-03-27T12:57:33+00:00" }, { "name": "psr/clock", "version": "1.0.0", "source": { "type": "git", "url": "https://github.com/php-fig/clock.git", "reference": "e41a24703d4560fd0acb709162f73b8adfc3aa0d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/clock/zipball/e41a24703d4560fd0acb709162f73b8adfc3aa0d", "reference": "e41a24703d4560fd0acb709162f73b8adfc3aa0d", "shasum": "" }, "require": { "php": "^7.0 || ^8.0" }, "type": "library", "autoload": { "psr-4": { "Psr\\Clock\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "Common interface for reading the clock.", "homepage": "https://github.com/php-fig/clock", "keywords": [ "clock", "now", "psr", "psr-20", "time" ], "support": { "issues": "https://github.com/php-fig/clock/issues", "source": "https://github.com/php-fig/clock/tree/1.0.0" }, "time": "2022-11-25T14:36:26+00:00" }, { "name": "psr/http-client", "version": "1.0.3", "source": { "type": "git", "url": "https://github.com/php-fig/http-client.git", "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/http-client/zipball/bb5906edc1c324c9a05aa0873d40117941e5fa90", "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90", "shasum": "" }, "require": { "php": "^7.0 || ^8.0", "psr/http-message": "^1.0 || ^2.0" }, "type": "library", "extra": { "branch-alias": { "dev-master": "1.0.x-dev" } }, "autoload": { "psr-4": { "Psr\\Http\\Client\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "Common interface for HTTP clients", "homepage": "https://github.com/php-fig/http-client", "keywords": [ "http", "http-client", "psr", "psr-18" ], "support": { "source": "https://github.com/php-fig/http-client" }, "time": "2023-09-23T14:17:50+00:00" }, { "name": "psr/http-factory", "version": "1.1.0", "source": { "type": "git", "url": "https://github.com/php-fig/http-factory.git", "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/http-factory/zipball/2b4765fddfe3b508ac62f829e852b1501d3f6e8a", "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a", "shasum": "" }, "require": { "php": ">=7.1", "psr/http-message": "^1.0 || ^2.0" }, "type": "library", "extra": { "branch-alias": { "dev-master": "1.0.x-dev" } }, "autoload": { "psr-4": { "Psr\\Http\\Message\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "PSR-17: Common interfaces for PSR-7 HTTP message factories", "keywords": [ "factory", "http", "message", "psr", "psr-17", "psr-7", "request", "response" ], "support": { "source": "https://github.com/php-fig/http-factory" }, "time": "2024-04-15T12:06:14+00:00" }, { "name": "psr/http-message", "version": "2.0", "source": { "type": "git", "url": "https://github.com/php-fig/http-message.git", "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/http-message/zipball/402d35bcb92c70c026d1a6a9883f06b2ead23d71", "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71", "shasum": "" }, "require": { "php": "^7.2 || ^8.0" }, "type": "library", "extra": { "branch-alias": { "dev-master": "2.0.x-dev" } }, "autoload": { "psr-4": { "Psr\\Http\\Message\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "Common interface for HTTP messages", "homepage": "https://github.com/php-fig/http-message", "keywords": [ "http", "http-message", "psr", "psr-7", "request", "response" ], "support": { "source": "https://github.com/php-fig/http-message/tree/2.0" }, "time": "2023-04-04T09:54:51+00:00" }, { "name": "ralouphie/getallheaders", "version": "3.0.3", "source": { "type": "git", "url": "https://github.com/ralouphie/getallheaders.git", "reference": "120b605dfeb996808c31b6477290a714d356e822" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/ralouphie/getallheaders/zipball/120b605dfeb996808c31b6477290a714d356e822", "reference": "120b605dfeb996808c31b6477290a714d356e822", "shasum": "" }, "require": { "php": ">=5.6" }, "require-dev": { "php-coveralls/php-coveralls": "^2.1", "phpunit/phpunit": "^5 || ^6.5" }, "type": "library", "autoload": { "files": [ "src/getallheaders.php" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Ralph Khattar", "email": "ralph.khattar@gmail.com" } ], "description": "A polyfill for getallheaders.", "support": { "issues": "https://github.com/ralouphie/getallheaders/issues", "source": "https://github.com/ralouphie/getallheaders/tree/develop" }, "time": "2019-03-08T08:55:37+00:00" }, { "name": "spatie/macroable", "version": "2.0.0", "source": { "type": "git", "url": "https://github.com/spatie/macroable.git", "reference": "ec2c320f932e730607aff8052c44183cf3ecb072" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/spatie/macroable/zipball/ec2c320f932e730607aff8052c44183cf3ecb072", "reference": "ec2c320f932e730607aff8052c44183cf3ecb072", "shasum": "" }, "require": { "php": "^8.0" }, "require-dev": { "phpunit/phpunit": "^8.0|^9.3" }, "type": "library", "autoload": { "psr-4": { "Spatie\\Macroable\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Freek Van der Herten", "email": "freek@spatie.be", "homepage": "https://spatie.be", "role": "Developer" } ], "description": "A trait to dynamically add methods to a class", "homepage": "https://github.com/spatie/macroable", "keywords": [ "macroable", "spatie" ], "support": { "issues": "https://github.com/spatie/macroable/issues", "source": "https://github.com/spatie/macroable/tree/2.0.0" }, "time": "2021-03-26T22:39:02+00:00" }, { "name": "spatie/url", "version": "2.4.0", "source": { "type": "git", "url": "https://github.com/spatie/url.git", "reference": "93a51db743cdec22b081c64593e193887c9cd395" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/spatie/url/zipball/93a51db743cdec22b081c64593e193887c9cd395", "reference": "93a51db743cdec22b081c64593e193887c9cd395", "shasum": "" }, "require": { "php": "^8.0", "psr/http-message": "^1.0 || ^2.0", "spatie/macroable": "^1.0 || ^2.0" }, "require-dev": { "pestphp/pest": "^1.21" }, "type": "library", "autoload": { "psr-4": { "Spatie\\Url\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Sebastian De Deyne", "email": "sebastian@spatie.be", "homepage": "https://spatie.be", "role": "Developer" } ], "description": "Parse, build and manipulate URL's", "homepage": "https://github.com/spatie/url", "keywords": [ "spatie", "url" ], "support": { "issues": "https://github.com/spatie/url/issues", "source": "https://github.com/spatie/url/tree/2.4.0" }, "funding": [ { "url": "https://spatie.be/open-source/support-us", "type": "custom" }, { "url": "https://github.com/spatie", "type": "github" } ], "time": "2024-03-08T11:35:19+00:00" }, { "name": "symfony/clock", "version": "v7.2.0", "source": { "type": "git", "url": "https://github.com/symfony/clock.git", "reference": "b81435fbd6648ea425d1ee96a2d8e68f4ceacd24" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/clock/zipball/b81435fbd6648ea425d1ee96a2d8e68f4ceacd24", "reference": "b81435fbd6648ea425d1ee96a2d8e68f4ceacd24", "shasum": "" }, "require": { "php": ">=8.2", "psr/clock": "^1.0", "symfony/polyfill-php83": "^1.28" }, "provide": { "psr/clock-implementation": "1.0" }, "type": "library", "autoload": { "files": [ "Resources/now.php" ], "psr-4": { "Symfony\\Component\\Clock\\": "" }, "exclude-from-classmap": [ "/Tests/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Decouples applications from the system clock", "homepage": "https://symfony.com", "keywords": [ "clock", "psr20", "time" ], "support": { "source": "https://github.com/symfony/clock/tree/v7.2.0" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-25T14:21:43+00:00" }, { "name": "symfony/deprecation-contracts", "version": "v3.5.1", "source": { "type": "git", "url": "https://github.com/symfony/deprecation-contracts.git", "reference": "74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6", "reference": "74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6", "shasum": "" }, "require": { "php": ">=8.1" }, "type": "library", "extra": { "thanks": { "url": "https://github.com/symfony/contracts", "name": "symfony/contracts" }, "branch-alias": { "dev-main": "3.5-dev" } }, "autoload": { "files": [ "function.php" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "A generic function and convention to trigger deprecation notices", "homepage": "https://symfony.com", "support": { "source": "https://github.com/symfony/deprecation-contracts/tree/v3.5.1" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-25T14:20:29+00:00" }, { "name": "symfony/polyfill-mbstring", "version": "v1.31.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-mbstring.git", "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/85181ba99b2345b0ef10ce42ecac37612d9fd341", "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341", "shasum": "" }, "require": { "php": ">=7.2" }, "provide": { "ext-mbstring": "*" }, "suggest": { "ext-mbstring": "For best performance" }, "type": "library", "extra": { "thanks": { "url": "https://github.com/symfony/polyfill", "name": "symfony/polyfill" } }, "autoload": { "files": [ "bootstrap.php" ], "psr-4": { "Symfony\\Polyfill\\Mbstring\\": "" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Symfony polyfill for the Mbstring extension", "homepage": "https://symfony.com", "keywords": [ "compatibility", "mbstring", "polyfill", "portable", "shim" ], "support": { "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.31.0" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-09T11:45:10+00:00" }, { "name": "symfony/polyfill-php83", "version": "v1.31.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-php83.git", "reference": "2fb86d65e2d424369ad2905e83b236a8805ba491" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/polyfill-php83/zipball/2fb86d65e2d424369ad2905e83b236a8805ba491", "reference": "2fb86d65e2d424369ad2905e83b236a8805ba491", "shasum": "" }, "require": { "php": ">=7.2" }, "type": "library", "extra": { "thanks": { "url": "https://github.com/symfony/polyfill", "name": "symfony/polyfill" } }, "autoload": { "files": [ "bootstrap.php" ], "psr-4": { "Symfony\\Polyfill\\Php83\\": "" }, "classmap": [ "Resources/stubs" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Symfony polyfill backporting some PHP 8.3+ features to lower PHP versions", "homepage": "https://symfony.com", "keywords": [ "compatibility", "polyfill", "portable", "shim" ], "support": { "source": "https://github.com/symfony/polyfill-php83/tree/v1.31.0" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-09T11:45:10+00:00" }, { "name": "symfony/translation", "version": "v7.2.4", "source": { "type": "git", "url": "https://github.com/symfony/translation.git", "reference": "283856e6981286cc0d800b53bd5703e8e363f05a" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/translation/zipball/283856e6981286cc0d800b53bd5703e8e363f05a", "reference": "283856e6981286cc0d800b53bd5703e8e363f05a", "shasum": "" }, "require": { "php": ">=8.2", "symfony/deprecation-contracts": "^2.5|^3", "symfony/polyfill-mbstring": "~1.0", "symfony/translation-contracts": "^2.5|^3.0" }, "conflict": { "symfony/config": "<6.4", "symfony/console": "<6.4", "symfony/dependency-injection": "<6.4", "symfony/http-client-contracts": "<2.5", "symfony/http-kernel": "<6.4", "symfony/service-contracts": "<2.5", "symfony/twig-bundle": "<6.4", "symfony/yaml": "<6.4" }, "provide": { "symfony/translation-implementation": "2.3|3.0" }, "require-dev": { "nikic/php-parser": "^4.18|^5.0", "psr/log": "^1|^2|^3", "symfony/config": "^6.4|^7.0", "symfony/console": "^6.4|^7.0", "symfony/dependency-injection": "^6.4|^7.0", "symfony/finder": "^6.4|^7.0", "symfony/http-client-contracts": "^2.5|^3.0", "symfony/http-kernel": "^6.4|^7.0", "symfony/intl": "^6.4|^7.0", "symfony/polyfill-intl-icu": "^1.21", "symfony/routing": "^6.4|^7.0", "symfony/service-contracts": "^2.5|^3", "symfony/yaml": "^6.4|^7.0" }, "type": "library", "autoload": { "files": [ "Resources/functions.php" ], "psr-4": { "Symfony\\Component\\Translation\\": "" }, "exclude-from-classmap": [ "/Tests/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Fabien Potencier", "email": "fabien@symfony.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Provides tools to internationalize your application", "homepage": "https://symfony.com", "support": { "source": "https://github.com/symfony/translation/tree/v7.2.4" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2025-02-13T10:27:23+00:00" }, { "name": "symfony/translation-contracts", "version": "v3.5.1", "source": { "type": "git", "url": "https://github.com/symfony/translation-contracts.git", "reference": "4667ff3bd513750603a09c8dedbea942487fb07c" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/4667ff3bd513750603a09c8dedbea942487fb07c", "reference": "4667ff3bd513750603a09c8dedbea942487fb07c", "shasum": "" }, "require": { "php": ">=8.1" }, "type": "library", "extra": { "thanks": { "url": "https://github.com/symfony/contracts", "name": "symfony/contracts" }, "branch-alias": { "dev-main": "3.5-dev" } }, "autoload": { "psr-4": { "Symfony\\Contracts\\Translation\\": "" }, "exclude-from-classmap": [ "/Test/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Generic abstractions related to translation", "homepage": "https://symfony.com", "keywords": [ "abstractions", "contracts", "decoupling", "interfaces", "interoperability", "standards" ], "support": { "source": "https://github.com/symfony/translation-contracts/tree/v3.5.1" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-25T14:20:29+00:00" } ], "packages-dev": [], "aliases": [], "minimum-stability": "stable", "stability-flags": {}, "prefer-stable": false, "prefer-lowest": false, "platform": { "php": "^8.1", "ext-json": "*", "ext-mbstring": "*" }, "platform-dev": {}, "plugin-api-version": "2.6.0" } php-core-1.3.0/src/000077500000000000000000000000001514131536700140255ustar00rootroot00000000000000php-core-1.3.0/src/Client/000077500000000000000000000000001514131536700152435ustar00rootroot00000000000000php-core-1.3.0/src/Client/SharpApiClient.php000066400000000000000000000404011514131536700206210ustar00rootroot00000000000000setApiKey($apiKey); if (empty($this->apiKey)) { throw new InvalidArgumentException('API key is required.'); } $this->setApiBaseUrl($apiBaseUrl ?? 'https://sharpapi.com/api/v1'); $this->setUserAgent($userAgent ?? 'SharpAPIPHPAgent/1.3.0'); $this->client = new Client([ 'headers' => $this->getHeaders() ]); } public function getApiBaseUrl(): string { return $this->apiBaseUrl; } public function setApiBaseUrl(string $apiBaseUrl): void { $this->apiBaseUrl = $apiBaseUrl; } public function getApiKey(): string { return $this->apiKey; } public function setApiKey(string $apiKey): void { $this->apiKey = $apiKey; } public function getUserAgent(): string { return $this->userAgent; } public function setUserAgent(string $userAgent): void { $this->userAgent = $userAgent; } public function getApiJobStatusPollingInterval(): int { return $this->apiJobStatusPollingInterval; } /** * @api * @param int $apiJobStatusPollingInterval * @return void */ public function setApiJobStatusPollingInterval(int $apiJobStatusPollingInterval): void { $this->apiJobStatusPollingInterval = $apiJobStatusPollingInterval; } public function isUseCustomInterval(): bool { return $this->useCustomInterval; } /** * @param bool $useCustomInterval * @return void * @api */ public function setUseCustomInterval(bool $useCustomInterval): void { $this->useCustomInterval = $useCustomInterval; } public function getApiJobStatusPollingWait(): int { return $this->apiJobStatusPollingWait; } /** * @param int $apiJobStatusPollingWait * @return void * @api */ public function setApiJobStatusPollingWait(int $apiJobStatusPollingWait): void { $this->apiJobStatusPollingWait = $apiJobStatusPollingWait; } /** * @return int|null The rate limit (requests per window) from the last API response, or null if not yet known. * @api */ public function getRateLimitLimit(): ?int { return $this->rateLimitLimit; } /** * @return int|null The remaining requests in the current window from the last API response, or null if not yet known. * @api */ public function getRateLimitRemaining(): ?int { return $this->rateLimitRemaining; } /** * @return int Maximum number of automatic retries on HTTP 429. * @api */ public function getMaxRetryOnRateLimit(): int { return $this->maxRetryOnRateLimit; } /** * @param int $maxRetryOnRateLimit Maximum number of automatic retries on HTTP 429. * @return void * @api */ public function setMaxRetryOnRateLimit(int $maxRetryOnRateLimit): void { $this->maxRetryOnRateLimit = $maxRetryOnRateLimit; } /** * @return int When remaining requests fall at or below this threshold, polling intervals are increased. * @api */ public function getRateLimitLowThreshold(): int { return $this->rateLimitLowThreshold; } /** * @param int $rateLimitLowThreshold When remaining requests fall at or below this threshold, polling intervals are increased. * @return void * @api */ public function setRateLimitLowThreshold(int $rateLimitLowThreshold): void { $this->rateLimitLowThreshold = $rateLimitLowThreshold; } /** * Sends a ping request to the API to check its availability and retrieve the current timestamp. * * @throws GuzzleException if the API request fails. * @api */ public function ping(): ?array { $response = $this->makeRequest('GET', '/ping'); return json_decode($response->getBody()->__toString(), true); } /** * Retrieves the subscription quota information. * * @return SubscriptionInfo|null A DTO containing subscription details. * @throws GuzzleException if the API request fails. * @throws Exception * @api */ public function quota(): ?SubscriptionInfo { $response = $this->makeRequest('GET', '/quota'); $info = json_decode($response->getBody()->__toString(), true); return new SubscriptionInfo( timestamp: new Carbon($info['timestamp']), on_trial: $info['on_trial'], trial_ends: new Carbon($info['trial_ends']), subscribed: $info['subscribed'], current_subscription_start: new Carbon($info['current_subscription_start']), current_subscription_end: new Carbon($info['current_subscription_end']), current_subscription_reset: new Carbon($info['current_subscription_reset']), subscription_words_quota: $info['subscription_words_quota'], subscription_words_used: $info['subscription_words_used'], subscription_words_used_percentage: $info['subscription_words_used_percentage'], requests_per_minute: $info['requests_per_minute'] ); } /** * Generic method to make an HTTP request using Guzzle. * * @param string $method The HTTP method (e.g., 'GET', 'POST'). * @param string $url The API endpoint relative to the base URL. * @param array $data Optional request data for POST requests. * @param string|null $filePath Optional file path for file upload. * @return ResponseInterface The Guzzle response object. * @throws GuzzleException if the request fails. */ protected function makeRequest( string $method, string $url, array $data = [], ?string $filePath = null ): ResponseInterface { $options = [ 'headers' => $this->getHeaders(), ]; if ($method === 'POST') { if (is_string($filePath) && strlen($filePath)) { $multipart = []; // Attach file $multipart[] = [ 'name' => 'file', 'contents' => file_get_contents($filePath), 'filename' => basename($filePath), ]; // Add each key-value pair from $data as a form-data field foreach ($data as $key => $value) { $multipart[] = [ 'name' => $key, 'contents' => is_array($value) ? json_encode($value) : $value, ]; } $options['multipart'] = $multipart; } else { $options['json'] = $data; } } return $this->executeWithRateLimitRetry($method, $this->getApiBaseUrl() . $url, $options); } /** * Makes a GET request with proper query parameter handling. * * This method was added to properly support GET requests with query parameters * for utility endpoints (airports, web scraping, skills, job positions). * Unlike the generic makeRequest() method which only handles POST data, * this method correctly passes query parameters using Guzzle's 'query' option. * * @param string $url The API endpoint relative to the base URL. * @param array $queryParams Query parameters to append to the URL. * @return ResponseInterface The Guzzle response object. * @throws GuzzleException if the request fails. * @api */ protected function makeGetRequest( string $url, array $queryParams = [] ): ResponseInterface { $options = [ 'headers' => $this->getHeaders(), ]; if (!empty($queryParams)) { $options['query'] = $queryParams; } return $this->executeWithRateLimitRetry('GET', $this->getApiBaseUrl() . $url, $options); } /** * @param ResponseInterface $response * @return mixed * @api */ protected function parseStatusUrl(ResponseInterface $response): mixed { return json_decode($response->getBody()->__toString(), true)['status_url']; } /** * Polls the API for job results, waiting for the job status to be `SUCCESS` or `FAILED`. * * @param string $statusUrl The URL to check the job status. * @return SharpApiJob A DTO representing the completed job with its result. * @throws ApiException|GuzzleException if the job fails or polling times out. * @api */ public function fetchResults(string $statusUrl): SharpApiJob { $waitingTime = 0; do { try { $response = $this->client->request('GET', $statusUrl, ['headers' => $this->getHeaders()]); } catch (ClientException $e) { if ($e->getResponse()->getStatusCode() === 429) { $retryResponse = $e->getResponse(); $this->extractRateLimitHeaders($retryResponse); $retryDelay = isset($retryResponse->getHeader('Retry-After')[0]) ? (int) $retryResponse->getHeader('Retry-After')[0] : $this->getApiJobStatusPollingInterval(); $waitingTime += $retryDelay; if ($waitingTime >= $this->getApiJobStatusPollingWait()) { throw new ApiException('Polling timed out while waiting for job completion (rate limited).', 429); } sleep($retryDelay); continue; } throw $e; } $this->extractRateLimitHeaders($response); $jobStatus = json_decode($response->getBody()->__toString(), true)['data']['attributes']; if ($jobStatus['status'] === SharpApiJobStatusEnum::SUCCESS->value || $jobStatus['status'] === SharpApiJobStatusEnum::FAILED->value) { break; } $retryAfter = isset($response->getHeader('Retry-After')[0]) ? (int)$response->getHeader('Retry-After')[0] : $this->getApiJobStatusPollingInterval(); if ($this->isUseCustomInterval()) { $retryAfter = $this->getApiJobStatusPollingInterval(); } $retryAfter = $this->adjustIntervalForRateLimit($retryAfter); $waitingTime += $retryAfter; if ($waitingTime >= $this->getApiJobStatusPollingWait()) { throw new ApiException('Polling timed out while waiting for job completion.'); } sleep($retryAfter); } while (true); $data = json_decode($response->getBody()->__toString(), true)['data']; $url = Url::fromString($statusUrl); $result = count($url->getSegments()) == 5 ? (object) json_decode($data['attributes']['result']) : (object) $data['attributes']['result']; return new SharpApiJob( id: $data['id'], type: $data['attributes']['type'], status: $data['attributes']['status'], result: $result ?? null ); } /** * Extracts rate-limit headers from an API response and stores them. * * @param ResponseInterface $response The API response. */ private function extractRateLimitHeaders(ResponseInterface $response): void { $limit = $response->getHeader('X-RateLimit-Limit'); if (!empty($limit)) { $this->rateLimitLimit = (int) $limit[0]; } $remaining = $response->getHeader('X-RateLimit-Remaining'); if (!empty($remaining)) { $this->rateLimitRemaining = (int) $remaining[0]; } } /** * Adjusts a polling interval when the rate-limit remaining count is low. * * When remaining is at or below the threshold, the base interval is multiplied * by a scaling factor that increases as remaining approaches 0. * * @param int $baseInterval The original polling interval in seconds. * @return int The adjusted interval. */ private function adjustIntervalForRateLimit(int $baseInterval): int { if ($this->rateLimitRemaining === null || $this->rateLimitRemaining > $this->rateLimitLowThreshold) { return $baseInterval; } // Scale: 2x at threshold, increasing as remaining approaches 0 $scale = 2 + ($this->rateLimitLowThreshold - $this->rateLimitRemaining); return $baseInterval * $scale; } /** * Wraps an HTTP request with automatic 429 retry logic. * * On success, rate-limit headers are extracted. On HTTP 429, the request is * retried after sleeping for the Retry-After duration, up to maxRetryOnRateLimit times. * All other client exceptions are re-thrown. * * @param string $method The HTTP method. * @param string $url The full request URL. * @param array $options Guzzle request options. * @return ResponseInterface The successful response. * @throws ApiException if retries are exhausted on 429. * @throws GuzzleException for non-429 failures. */ private function executeWithRateLimitRetry(string $method, string $url, array $options): ResponseInterface { $attempts = 0; while (true) { try { $response = $this->client->request($method, $url, $options); $this->extractRateLimitHeaders($response); return $response; } catch (ClientException $e) { if ($e->getResponse()->getStatusCode() !== 429) { throw $e; } $attempts++; $retryResponse = $e->getResponse(); $this->extractRateLimitHeaders($retryResponse); if ($attempts >= $this->maxRetryOnRateLimit) { throw new ApiException( 'Rate limit exceeded. Retries exhausted after ' . $attempts . ' attempts.', 429 ); } $retryAfter = isset($retryResponse->getHeader('Retry-After')[0]) ? (int) $retryResponse->getHeader('Retry-After')[0] : 1; sleep($retryAfter); } } } /** * Prepares the headers for API requests. * * @return array An associative array of headers. */ private function getHeaders(): array { return [ 'Authorization' => 'Bearer ' . $this->getApiKey(), 'Accept' => 'application/json', 'User-Agent' => $this->getUserAgent() ]; } } php-core-1.3.0/src/DTO/000077500000000000000000000000001514131536700144535ustar00rootroot00000000000000php-core-1.3.0/src/DTO/SharpApiJob.php000066400000000000000000000036571514131536700173410ustar00rootroot00000000000000 $this->id, 'type' => $this->type, 'status' => $this->status, 'result' => $this->result, ]; } /** * Returns the job result as a prettified JSON string. * @api * @return string|bool|null The JSON-encoded result, or null if no result. */ public function getResultJson(): string|bool|null { return $this->result ? json_encode($this->result, JSON_PRETTY_PRINT) : null; } /** * Returns the job result as a PHP associative array. * @api * @return array|null The result as an associative array, or null if no result. */ public function getResultArray(): ?array { return $this->result ? (array) $this->result : null; } /** * Returns the job result as a PHP stdClass object. * @api * @return stdClass|null The result as an object, or null if no result. */ public function getResultObject(): ?stdClass { return $this->result; } } php-core-1.3.0/src/DTO/SubscriptionInfo.php000066400000000000000000000055571514131536700205000ustar00rootroot00000000000000 $this->timestamp->toDateTimeString(), 'on_trial' => $this->on_trial, 'trial_ends' => $this->trial_ends->toDateTimeString(), 'subscribed' => $this->subscribed, 'current_subscription_start' => $this->current_subscription_start->toDateTimeString(), 'current_subscription_end' => $this->current_subscription_end->toDateTimeString(), 'current_subscription_reset' => $this->current_subscription_reset->toDateTimeString(), 'subscription_words_quota' => $this->subscription_words_quota, 'subscription_words_used' => $this->subscription_words_used, 'subscription_words_used_percentage' => $this->subscription_words_used_percentage, 'requests_per_minute' => $this->requests_per_minute, ]; } } php-core-1.3.0/src/Enums/000077500000000000000000000000001514131536700151145ustar00rootroot00000000000000php-core-1.3.0/src/Enums/SharpApiJobStatusEnum.php000066400000000000000000000017741514131536700220310ustar00rootroot00000000000000 'New', self::PENDING => 'Pending', self::FAILED => 'Failed', self::SUCCESS => 'Success', }; } /** * Get a color associated with each status for UI representation. * * @return string * @api */ public function color(): string { return match ($this) { self::NEW => 'gray', self::PENDING => 'yellow', self::FAILED => 'red', self::SUCCESS => 'green', }; } } php-core-1.3.0/src/Exceptions/000077500000000000000000000000001514131536700161465ustar00rootroot00000000000000php-core-1.3.0/src/Exceptions/ApiException.php000066400000000000000000000002471514131536700212520ustar00rootroot00000000000000