├── .dockerignore
├── .editorconfig
├── .github
    ├── ISSUE_TEMPLATE
    │   ├── bug_report.md
    │   └── config.yml
    ├── scripts
    │   └── generate_changelog.py
    └── workflows
    │   ├── auto-release.yml
    │   ├── build.yml
    │   ├── delete-old-builds.yml
    │   └── stale.yml
├── .gitignore
├── .phpstorm.meta.php
├── CHANGELOG.md
├── Dockerfile
├── FAQ.md
├── LICENSE
├── NEWS.md
├── README.md
├── bin
    └── console
├── composer.json
├── composer.lock
├── config
    ├── Middlewares.php
    ├── config.php
    ├── directories.php
    ├── env.spec.php
    ├── languageCodes.php
    ├── servers.spec.php
    └── services.php
├── container
    └── files
    │   ├── init-container.sh
    │   └── redis.conf
├── frontend
    ├── .gitignore
    ├── assets
    │   ├── css
    │   │   ├── all.css
    │   │   ├── bulma-switch.css
    │   │   ├── bulma.css
    │   │   └── style.css
    │   └── webfonts
    │   │   ├── fa-brands-400.ttf
    │   │   ├── fa-brands-400.woff2
    │   │   ├── fa-regular-400.ttf
    │   │   ├── fa-regular-400.woff2
    │   │   ├── fa-solid-900.ttf
    │   │   ├── fa-solid-900.woff2
    │   │   ├── fa-v4compatibility.ttf
    │   │   └── fa-v4compatibility.woff2
    ├── components
    │   ├── BackendAdd.vue
    │   ├── Confirm.vue
    │   ├── EventView.vue
    │   ├── Lazy.vue
    │   ├── Markdown.vue
    │   ├── Message.vue
    │   ├── Overlay.vue
    │   ├── Pager.vue
    │   ├── Player.vue
    │   ├── Settings.vue
    │   ├── TaskScheduler.vue
    │   └── UserSelection.vue
    ├── composables
    │   └── useToast.js
    ├── error.vue
    ├── layouts
    │   ├── default.vue
    │   └── guest.vue
    ├── middleware
    │   └── auth.global.js
    ├── nuxt.config.ts
    ├── package.json
    ├── pages
    │   ├── auth.vue
    │   ├── backend
    │   │   └── [backend]
    │   │   │   ├── delete.vue
    │   │   │   ├── edit.vue
    │   │   │   ├── index.vue
    │   │   │   ├── libraries.vue
    │   │   │   ├── mismatched.vue
    │   │   │   ├── search.vue
    │   │   │   ├── sessions.vue
    │   │   │   ├── stale
    │   │   │       └── [id].vue
    │   │   │   ├── unmatched.vue
    │   │   │   └── users.vue
    │   ├── backends
    │   │   └── index.vue
    │   ├── backup.vue
    │   ├── changelog.vue
    │   ├── console.vue
    │   ├── custom
    │   │   ├── add.vue
    │   │   ├── addlink.vue
    │   │   └── index.vue
    │   ├── env.vue
    │   ├── events.vue
    │   ├── help
    │   │   ├── [...slug].vue
    │   │   └── index.vue
    │   ├── history
    │   │   ├── [id]
    │   │   │   └── index.vue
    │   │   └── index.vue
    │   ├── ignore.vue
    │   ├── index.vue
    │   ├── integrity.vue
    │   ├── logs
    │   │   ├── [filename].vue
    │   │   └── index.vue
    │   ├── parity.vue
    │   ├── play
    │   │   └── [id].vue
    │   ├── processes.vue
    │   ├── purge_cache.vue
    │   ├── report.vue
    │   ├── reset.vue
    │   ├── suppression.vue
    │   ├── tasks.vue
    │   ├── tools
    │   │   ├── plex_token.vue
    │   │   └── sub_users.vue
    │   └── url_check.vue
    ├── plugins
    │   ├── toast.js
    │   └── vuedraggable.client.js
    ├── pnpm-lock.yaml
    ├── public
    │   ├── favicon.ico
    │   └── images
    │   │   └── logo.png
    ├── store
    │   └── auth.js
    ├── tsconfig.json
    ├── utils
    │   ├── awaiter.ts
    │   ├── cache.js
    │   ├── events
    │   │   └── helpers.js
    │   ├── index.js
    │   └── request.js
    └── web-types.json
├── guides
    ├── one-way-sync.md
    ├── two-way-sync.md
    ├── webhooks-legacy.md
    └── webhooks.md
├── migrations
    ├── sqlite_1644418046_create_state_table.sql
    ├── sqlite_1718473650_add_created_updated_at_fields.sql
    ├── sqlite_1723926051_add_events_table.sql
    └── sqlite_1723988129_add-reference-to-events.sql
├── phpstan.neon
├── phpunit.xml.dist
├── pre_init.php
├── psalm.xml.dist
├── public
    └── index.php
├── screenshots
    ├── add_backend.png
    └── index.png
├── src
    ├── API
    │   ├── Backend
    │   │   ├── AccessToken.php
    │   │   ├── Delete.php
    │   │   ├── Discover.php
    │   │   ├── Ignore.php
    │   │   ├── Index.php
    │   │   ├── Info.php
    │   │   ├── Library.php
    │   │   ├── Mismatched.php
    │   │   ├── Option.php
    │   │   ├── Search.php
    │   │   ├── Sessions.php
    │   │   ├── Stale.php
    │   │   ├── Unmatched.php
    │   │   ├── Update.php
    │   │   ├── Users.php
    │   │   ├── Version.php
    │   │   └── Webhooks.php
    │   ├── Backends
    │   │   ├── AccessToken.php
    │   │   ├── Add.php
    │   │   ├── Discover.php
    │   │   ├── Index.php
    │   │   ├── Mapper.php
    │   │   ├── PlexToken.php
    │   │   ├── Spec.php
    │   │   ├── UUid.php
    │   │   ├── Users.php
    │   │   └── ValidateToken.php
    │   ├── History
    │   │   └── Index.php
    │   ├── Ignore
    │   │   └── Index.php
    │   ├── Logs
    │   │   └── Index.php
    │   ├── Player
    │   │   ├── Index.php
    │   │   ├── M3u8.php
    │   │   ├── Playlist.php
    │   │   ├── Segments.php
    │   │   └── Subtitle.php
    │   ├── System
    │   │   ├── Auth.php
    │   │   ├── Backup.php
    │   │   ├── Cache.php
    │   │   ├── Command.php
    │   │   ├── Env.php
    │   │   ├── Events.php
    │   │   ├── Explode.php
    │   │   ├── Guids.php
    │   │   ├── HealthCheck.php
    │   │   ├── Images.php
    │   │   ├── Integrity.php
    │   │   ├── Parity.php
    │   │   ├── Processes.php
    │   │   ├── Report.php
    │   │   ├── Reset.php
    │   │   ├── Scheduler.php
    │   │   ├── Sign.php
    │   │   ├── Supported.php
    │   │   ├── Suppressor.php
    │   │   ├── ToYaml.php
    │   │   ├── UrlChecker.php
    │   │   ├── Users.php
    │   │   └── Version.php
    │   ├── Tasks.php
    │   └── Webhook
    │   │   └── Index.php
    ├── Backends
    │   ├── Common
    │   │   ├── Cache.php
    │   │   ├── ClientInterface.php
    │   │   ├── CommonTrait.php
    │   │   ├── Context.php
    │   │   ├── Error.php
    │   │   ├── GuidInterface.php
    │   │   ├── Levels.php
    │   │   ├── ManageInterface.php
    │   │   ├── Request.php
    │   │   └── Response.php
    │   ├── Emby
    │   │   ├── Action
    │   │   │   ├── Backup.php
    │   │   │   ├── Export.php
    │   │   │   ├── GenerateAccessToken.php
    │   │   │   ├── GetIdentifier.php
    │   │   │   ├── GetInfo.php
    │   │   │   ├── GetLibrariesList.php
    │   │   │   ├── GetLibrary.php
    │   │   │   ├── GetMetaData.php
    │   │   │   ├── GetSessions.php
    │   │   │   ├── GetUser.php
    │   │   │   ├── GetUsersList.php
    │   │   │   ├── GetVersion.php
    │   │   │   ├── GetWebUrl.php
    │   │   │   ├── Import.php
    │   │   │   ├── InspectRequest.php
    │   │   │   ├── ParseWebhook.php
    │   │   │   ├── Progress.php
    │   │   │   ├── Proxy.php
    │   │   │   ├── Push.php
    │   │   │   ├── SearchId.php
    │   │   │   ├── SearchQuery.php
    │   │   │   ├── ToEntity.php
    │   │   │   ├── UpdateState.php
    │   │   │   └── getImagesUrl.php
    │   │   ├── EmbyActionTrait.php
    │   │   ├── EmbyClient.php
    │   │   ├── EmbyGuid.php
    │   │   ├── EmbyManage.php
    │   │   └── EmbyValidateContext.php
    │   ├── Jellyfin
    │   │   ├── Action
    │   │   │   ├── Backup.php
    │   │   │   ├── Export.php
    │   │   │   ├── GenerateAccessToken.php
    │   │   │   ├── GetIdentifier.php
    │   │   │   ├── GetInfo.php
    │   │   │   ├── GetLibrariesList.php
    │   │   │   ├── GetLibrary.php
    │   │   │   ├── GetMetaData.php
    │   │   │   ├── GetSessions.php
    │   │   │   ├── GetUser.php
    │   │   │   ├── GetUsersList.php
    │   │   │   ├── GetVersion.php
    │   │   │   ├── GetWebUrl.php
    │   │   │   ├── Import.php
    │   │   │   ├── InspectRequest.php
    │   │   │   ├── ParseWebhook.php
    │   │   │   ├── Progress.php
    │   │   │   ├── Proxy.php
    │   │   │   ├── Push.php
    │   │   │   ├── SearchId.php
    │   │   │   ├── SearchQuery.php
    │   │   │   ├── ToEntity.php
    │   │   │   ├── UpdateState.php
    │   │   │   └── getImagesUrl.php
    │   │   ├── JellyfinActionTrait.php
    │   │   ├── JellyfinClient.php
    │   │   ├── JellyfinGuid.php
    │   │   ├── JellyfinManage.php
    │   │   └── JellyfinValidateContext.php
    │   └── Plex
    │   │   ├── Action
    │   │       ├── Backup.php
    │   │       ├── Export.php
    │   │       ├── GetIdentifier.php
    │   │       ├── GetInfo.php
    │   │       ├── GetLibrariesList.php
    │   │       ├── GetLibrary.php
    │   │       ├── GetMetaData.php
    │   │       ├── GetSessions.php
    │   │       ├── GetUser.php
    │   │       ├── GetUserToken.php
    │   │       ├── GetUsersList.php
    │   │       ├── GetVersion.php
    │   │       ├── GetWebUrl.php
    │   │       ├── Import.php
    │   │       ├── InspectRequest.php
    │   │       ├── ParseWebhook.php
    │   │       ├── Progress.php
    │   │       ├── Proxy.php
    │   │       ├── Push.php
    │   │       ├── SearchId.php
    │   │       ├── SearchQuery.php
    │   │       ├── ToEntity.php
    │   │       ├── UpdateState.php
    │   │       └── getImagesUrl.php
    │   │   ├── Commands
    │   │       ├── AccessTokenCommand.php
    │   │       ├── CheckTokenCommand.php
    │   │       └── DiscoverCommand.php
    │   │   ├── PlexActionTrait.php
    │   │   ├── PlexClient.php
    │   │   ├── PlexGuid.php
    │   │   ├── PlexManage.php
    │   │   └── PlexValidateContext.php
    ├── Cli.php
    ├── Command.php
    ├── Commands
    │   ├── Backend
    │   │   ├── CreateUsersCommand.php
    │   │   ├── Ignore
    │   │   │   ├── ListCommand.php
    │   │   │   └── ManageCommand.php
    │   │   ├── InfoCommand.php
    │   │   ├── Library
    │   │   │   ├── IgnoreCommand.php
    │   │   │   ├── ListCommand.php
    │   │   │   ├── MismatchCommand.php
    │   │   │   └── UnmatchedCommand.php
    │   │   ├── RestoreCommand.php
    │   │   ├── Search
    │   │   │   ├── IdCommand.php
    │   │   │   └── QueryCommand.php
    │   │   ├── Users
    │   │   │   ├── ListCommand.php
    │   │   │   └── SessionsCommand.php
    │   │   └── VersionCommand.php
    │   ├── Config
    │   │   ├── AddCommand.php
    │   │   ├── DeleteCommand.php
    │   │   ├── EditCommand.php
    │   │   ├── ListCommand.php
    │   │   ├── ManageCommand.php
    │   │   ├── TestCommand.php
    │   │   └── ViewCommand.php
    │   ├── Database
    │   │   ├── ListCommand.php
    │   │   ├── ParityCommand.php
    │   │   ├── QueueCommand.php
    │   │   └── RepairCommand.php
    │   ├── Events
    │   │   ├── CacheCommand.php
    │   │   ├── DispatchCommand.php
    │   │   ├── ListenersCommand.php
    │   │   └── QueuedCommand.php
    │   ├── State
    │   │   ├── BackupCommand.php
    │   │   ├── ExportCommand.php
    │   │   ├── ImportCommand.php
    │   │   └── ValidateCommand.php
    │   └── System
    │   │   ├── APIKeyCommand.php
    │   │   ├── DiffCommand.php
    │   │   ├── EnvCommand.php
    │   │   ├── IndexCommand.php
    │   │   ├── LogsCommand.php
    │   │   ├── MaintenanceCommand.php
    │   │   ├── MakeCommand.php
    │   │   ├── MigrationsCommand.php
    │   │   ├── PHPCommand.php
    │   │   ├── PruneCommand.php
    │   │   ├── ReportCommand.php
    │   │   ├── ResetCommand.php
    │   │   ├── ResetPasswordCommand.php
    │   │   ├── RoutesCommand.php
    │   │   ├── SchedulerCommand.php
    │   │   ├── ServerCommand.php
    │   │   ├── SuppressCommand.php
    │   │   ├── TasksCommand.php
    │   │   └── TinkerCommand.php
    ├── Libs
    │   ├── APIResponse.php
    │   ├── Attributes
    │   │   ├── DI
    │   │   │   └── Inject.php
    │   │   ├── Route
    │   │   │   ├── Cli.php
    │   │   │   ├── Delete.php
    │   │   │   ├── Get.php
    │   │   │   ├── Head.php
    │   │   │   ├── Options.php
    │   │   │   ├── Patch.php
    │   │   │   ├── Post.php
    │   │   │   ├── Put.php
    │   │   │   └── Route.php
    │   │   └── Scanner
    │   │   │   ├── Attributes.php
    │   │   │   ├── Item.php
    │   │   │   └── Target.php
    │   ├── Config.php
    │   ├── ConfigFile.php
    │   ├── Container.php
    │   ├── DataUtil.php
    │   ├── Database
    │   │   ├── DBLayer.php
    │   │   ├── DatabaseInterface.php
    │   │   └── PDO
    │   │   │   ├── PDOAdapter.php
    │   │   │   ├── PDODataMigration.php
    │   │   │   ├── PDOIndexer.php
    │   │   │   └── PDOMigrations.php
    │   ├── Emitter.php
    │   ├── Entity
    │   │   ├── StateEntity.php
    │   │   └── StateInterface.php
    │   ├── Enums
    │   │   └── Http
    │   │   │   ├── Method.php
    │   │   │   └── Status.php
    │   ├── EnvFile.php
    │   ├── Events
    │   │   └── DataEvent.php
    │   ├── Exceptions
    │   │   ├── AppExceptionInterface.php
    │   │   ├── Backends
    │   │   │   ├── BackendException.php
    │   │   │   ├── InvalidArgumentException.php
    │   │   │   ├── InvalidContextException.php
    │   │   │   ├── NotImplementedException.php
    │   │   │   ├── RuntimeException.php
    │   │   │   └── UnexpectedVersionException.php
    │   │   ├── DBAdapterException.php
    │   │   ├── DBLayerException.php
    │   │   ├── EmitterException.php
    │   │   ├── ErrorException.php
    │   │   ├── HttpException.php
    │   │   ├── InvalidArgumentException.php
    │   │   ├── RuntimeException.php
    │   │   ├── UseAppException.php
    │   │   └── ValidationException.php
    │   ├── Extends
    │   │   ├── ConsoleHandler.php
    │   │   ├── ConsoleOutput.php
    │   │   ├── Date.php
    │   │   ├── HttpClient.php
    │   │   ├── LogMessageProcessor.php
    │   │   ├── LoggerProxy.php
    │   │   ├── MockHttpClient.php
    │   │   ├── PSRContainer.php
    │   │   ├── ProxyHandler.php
    │   │   ├── ReflectionContainer.php
    │   │   ├── RemoteHandler.php
    │   │   ├── RetryableHttpClient.php
    │   │   ├── RouterStrategy.php
    │   │   ├── StreamLogHandler.php
    │   │   └── StreamableChunks.php
    │   ├── Guid.php
    │   ├── Initializer.php
    │   ├── IpUtils.php
    │   ├── LogSuppressor.php
    │   ├── Mappers
    │   │   ├── Import
    │   │   │   ├── DirectMapper.php
    │   │   │   ├── MemoryMapper.php
    │   │   │   ├── ReadOnlyMapper.php
    │   │   │   └── RestoreMapper.php
    │   │   └── ImportInterface.php
    │   ├── Message.php
    │   ├── Middlewares
    │   │   ├── AddCorsMiddleware.php
    │   │   ├── AddTimingMiddleware.php
    │   │   ├── AuthorizationMiddleware.php
    │   │   ├── ExceptionHandlerMiddleware.php
    │   │   ├── NoAccessLogMiddleware.php
    │   │   └── ParseJsonBodyMiddleware.php
    │   ├── Options.php
    │   ├── Profiler.php
    │   ├── QueueRequests.php
    │   ├── Response.php
    │   ├── ServeStatic.php
    │   ├── Server.php
    │   ├── Stream.php
    │   ├── StreamedBody.php
    │   ├── TestCase.php
    │   ├── TokenUtil.php
    │   ├── Traits
    │   │   └── APITraits.php
    │   ├── Uri.php
    │   ├── UserContext.php
    │   ├── Utils.php
    │   ├── VttConverter.php
    │   └── helpers.php
    ├── Listeners
    │   ├── ProcessProfileEvent.php
    │   ├── ProcessProgressEvent.php
    │   ├── ProcessPushEvent.php
    │   └── ProcessRequestEvent.php
    └── Model
    │   ├── Base
    │       ├── BasicModel.php
    │       ├── BasicValidation.php
    │       ├── Enums
    │       │   ├── ScalarType.php
    │       │   └── TransformType.php
    │       ├── Exceptions
    │       │   ├── MustBeNonEmpty.php
    │       │   ├── VDateTypeException.php
    │       │   ├── VFilterException.php
    │       │   ├── VValidateException.php
    │       │   └── ValidationException.php
    │       ├── Interfaces
    │       │   └── IDInterface.php
    │       ├── Traits
    │       │   ├── UsesBasicRepository.php
    │       │   └── UsesPaging.php
    │       └── Transformers
    │       │   ├── ArrayTransformer.php
    │       │   ├── DateTransformer.php
    │       │   ├── EnumTransformer.php
    │       │   ├── JSONTransformer.php
    │       │   ├── ScalarTransformer.php
    │       │   ├── SerializeTransformer.php
    │       │   └── TimestampTransformer.php
    │   └── Events
    │       ├── Event.php
    │       ├── EventListener.php
    │       ├── EventStatus.php
    │       ├── EventValidation.php
    │       ├── EventsRepository.php
    │       └── EventsTable.php
├── tests
    ├── Backends
    │   ├── Common
    │   │   ├── CacheTest.php
    │   │   ├── ErrorTest.php
    │   │   └── ResponseTest.php
    │   ├── Emby
    │   │   └── EmbyGuidTest.php
    │   ├── Jellyfin
    │   │   └── JellyfinGuidTest.php
    │   └── Plex
    │   │   ├── GetLibrariesListTest.php
    │   │   └── PlexGuidTest.php
    ├── Database
    │   ├── DBLayerTest.php
    │   └── PDOAdapterTest.php
    ├── Fixtures
    │   ├── EpisodeEntity.php
    │   ├── MovieEntity.php
    │   ├── local_data
    │   │   ├── fanart.png
    │   │   ├── poster.jpg
    │   │   ├── test.mkv
    │   │   ├── test.png
    │   │   └── test.srt
    │   ├── meminfo_data.txt
    │   ├── plex_data.json
    │   ├── static_data
    │   │   ├── test.css
    │   │   ├── test.html
    │   │   ├── test.js
    │   │   ├── test.json
    │   │   ├── test.md
    │   │   ├── test.woff2
    │   │   ├── test
    │   │   │   └── index.html
    │   │   └── test2
    │   │   │   └── test.html
    │   ├── subtitle.exported.vtt
    │   ├── subtitle.json
    │   ├── subtitle.vtt
    │   ├── test_env_vars
    │   └── test_servers.yaml
    ├── Libs
    │   ├── APIResponseTest.php
    │   ├── ConfigFileTest.php
    │   ├── ConfigTest.php
    │   ├── DataUtilTest.php
    │   ├── EmitterTest.php
    │   ├── Enums
    │   │   └── Http
    │   │   │   ├── MethodTest.php
    │   │   │   └── StatusTest.php
    │   ├── Events
    │   │   └── DataEventTest.php
    │   ├── GuidTest.php
    │   ├── HelpersTest.php
    │   ├── LogSuppressorTest.php
    │   ├── MessageTest.php
    │   ├── Middlewares
    │   │   ├── AddCorsMiddlewareTest.php
    │   │   ├── AuthorizationMiddlewareTest.php
    │   │   ├── ExceptionHandlerMiddlewareTest.php
    │   │   ├── NoAccessLogMiddlewareTest.php
    │   │   └── ParseJsonBodyMiddlewareTest.php
    │   ├── QueueRequestsTest.php
    │   ├── ResponseTest.php
    │   ├── ServeStaticTest.php
    │   ├── StateEntityTest.php
    │   ├── StreamTest.php
    │   ├── StreamedBodyTest.php
    │   ├── Traits
    │   │   └── APITraitsTest.php
    │   ├── UriTest.php
    │   ├── VttConverterTest.php
    │   └── envFileTest.php
    ├── Mappers
    │   └── Import
    │   │   ├── DirectMapperTest.php
    │   │   ├── MapperAbstract.php
    │   │   └── MemoryMapperTest.php
    ├── Server
    │   ├── ServerTest.php
    │   └── resources
    │   │   ├── index.html
    │   │   └── index.php
    ├── Support
    │   └── RequestResponseTrait.php
    └── bootstrap.php
└── var
    └── .gitignore


/.dockerignore:
--------------------------------------------------------------------------------
1 | **/.idea
2 | **/.git
3 | **/vendor
4 | ./var/*
5 | !./var/.gitignore
6 | .phpunit.result.cache
7 | frontend/.nuxt
8 | frontend/node_modules
9 | 


--------------------------------------------------------------------------------
/.editorconfig:
--------------------------------------------------------------------------------
 1 | # EditorConfig is awesome: http://EditorConfig.org
 2 | 
 3 | # top-most EditorConfig file
 4 | root = true
 5 | 
 6 | # All PHP files MUST use the Unix LF (linefeed) line ending.
 7 | # Code MUST use an indent of 4 spaces, and MUST NOT use tabs for indenting.
 8 | # All PHP files MUST end with a single blank line.
 9 | # There MUST NOT be trailing whitespace at the end of non-blank lines.
10 | [*]
11 | charset = utf-8
12 | end_of_line = lf
13 | insert_final_newline = true
14 | trim_trailing_whitespace = true
15 | indent_style = space
16 | 
17 | # PHP-Files, Composer.json, MD-Files
18 | [{*.php,composer.json,*.md}]
19 | indent_size = 4
20 | 
21 | # HTML-Files LESS-Files SASS-Files CSS-Files JS-Files JSON-Files
22 | [{*.html,*.less,*.sass,*.css,*.js,*.json}]
23 | indent_size = 4
24 | 
25 | # Gitlab-CI, Travis-CI
26 | [{*.yml,*.yaml}]
27 | indent_size = 2
28 | 
29 | [*.md]
30 | trim_trailing_whitespace = false
31 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/bug_report.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | name: Bug report
 3 | about: Report bug/problem in the tool.
 4 | title: "[BUG]"
 5 | labels: ''
 6 | assignees: ''
 7 | 
 8 | ---
 9 | 
10 | **Describe the bug**
11 | <!--
12 | Please Describe the problem you are facing.
13 | -->
14 | 
15 | **To Reproduce**
16 | <!--
17 | What steps did you do to reach the bug?
18 | -->
19 | 
20 | **Expected behavior**
21 | <!--
22 | A clear and concise description of what you expected to happen.
23 | -->
24 | 
25 | **Screenshots**
26 | <!-- 
27 | Attach screenshots if it helps explain your bug report.
28 | -->
29 | 
30 | **Basic report**
31 | <!-- 
32 | # Please use the following command to generate basic report to help us diagnose the issue
33 | # Make sure review the logs sections as it might have some private information.
34 | 
35 | docker exec -ti watchstate console system:report
36 | 
37 | Please put the output in a code block like this
38 | -->
39 | 
40 | ```
41 | Paste the system:report output here
42 | ```
43 | 
44 | **Additional context**
45 | <!-- 
46 | Add any other context about the problem here.
47 | -->
48 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/config.yml:
--------------------------------------------------------------------------------
 1 | blank_issues_enabled: false
 2 | contact_links:
 3 |   - name: Feature request
 4 |     url: https://github.com/arabcoders/watchstate/discussions
 5 |     about: Please use the discussions tab for features or enhancements requests.
 6 |   - name: Questions & Answers
 7 |     url: https://github.com/arabcoders/watchstate/discussions
 8 |     about: Please use the discussions tab for long questions and general discussions.
 9 |   - name: Discord Link.
10 |     url: https://discord.gg/haUXHJyj6Y
11 |     about: Use Discord for quick questions like can you do XX? etc or quick support requests.
12 | 


--------------------------------------------------------------------------------
/.github/workflows/delete-old-builds.yml:
--------------------------------------------------------------------------------
 1 | name: Remove old builds.
 2 | 
 3 | on:
 4 |   workflow_dispatch:
 5 |     inputs:
 6 |       logLevel:
 7 |         description: "Log level"
 8 |         required: false
 9 |         default: "warning"
10 |         type: choice
11 |         options:
12 |           - info
13 |           - warning
14 |           - debug
15 | 
16 | jobs:
17 |   remove-builds:
18 |     runs-on: ubuntu-latest
19 |     permissions:
20 |       packages: write
21 |     steps:
22 |       - uses: actions/delete-package-versions@v4
23 |         with:
24 |           package-name: "watchstate"
25 |           package-type: "container"
26 |           min-versions-to-keep: 50
27 | 


--------------------------------------------------------------------------------
/.github/workflows/stale.yml:
--------------------------------------------------------------------------------
 1 | name: Stale Issue Closer
 2 | permissions:
 3 |   issues: write
 4 | 
 5 | on:
 6 |   schedule:
 7 |     #        ┌───────────── minute (0 - 59)
 8 |     #        │ ┌───────────── hour (0 - 23)
 9 |     #        │ │ ┌───────────── day of the month (1 - 31)
10 |     #        │ │ │ ┌───────────── month (1 - 12 or JAN-DEC)
11 |     #        │ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
12 |     #        │ │ │ │ │
13 |     #        │ │ │ │ │
14 |     #        │ │ │ │ │
15 |     #        * * * * *
16 |     - cron: "0 0 * * *"
17 | 
18 | jobs:
19 |   main:
20 |     runs-on: ubuntu-latest
21 |     steps:
22 |       - name: Checkout Actions
23 |         uses: actions/checkout@v3
24 |         with:
25 |           repository: "microsoft/vscode-github-triage-actions"
26 |           path: ./actions
27 |           ref: stable
28 |       - name: Install Actions
29 |         run: npm install --production --prefix ./actions
30 |       - name: Run Stale Issue Closer
31 |         uses: ./actions/needs-more-info-closer
32 |         with:
33 |           token: ${{ secrets.GITHUB_TOKEN }}
34 |           label: waiting for user response
35 |           # Close issues that are marked a 'waiting for user response' label and were last interacted with by a contributor or bot, after 30 days has passed.
36 |           closeDays: 12
37 |           closeComment: "This issue has been closed automatically because it needs more information and has not had recent activity. If the issue still persists, please reopen with the information requested. Thanks."
38 |           # Ping the assignee if the last comment was by someone other than a team member or bot after 7 days has passed.
39 |           pingDays: 7
40 |           pingComment: "Hey @${assignee}, this issue might need further attention.\n\n@${author}, you can help us out by closing this issue if the problem no longer exists, or adding more information."
41 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | /.idea/*
2 | /vendor/*
3 | /.env
4 | /.phpunit.result.cache
5 | /.vscode
6 | /frontend/exported/
7 | .phpactor.json
8 | **.php-cs-fixer.cache
9 | 


--------------------------------------------------------------------------------
/.phpstorm.meta.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace PHPSTORM_META;
 4 | 
 5 | override(\Psr\Container\ContainerInterface::get(0), map(['' => '@']));
 6 | override(\League\Container\ReflectionContainer::get(0), map(['' => '@']));
 7 | override(
 8 |     \App\Command::getHelper(0),
 9 |     map([
10 |         'question' => QuestionHelper::class,
11 |     ])
12 | );
13 | override(
14 |     \Symfony\Component\Console\Command\Command::getHelper(0),
15 |     map([
16 |         'question' => \Symfony\Component\Console\Helper\SymfonyQuestionHelper::class,
17 |     ])
18 | );
19 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
1 | # CHANGELOG
2 | 
3 | This file will be populated automatically via github action for containers.
4 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2024 ArabCoders
 2 | 
 3 | Permission is hereby granted, free of charge, to any person obtaining a copy
 4 | of this software and associated documentation files (the "Software"), to deal
 5 | in the Software without restriction, including without limitation the rights
 6 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 7 | copies of the Software, and to permit persons to whom the Software is furnished
 8 | to do so, subject to the following conditions:
 9 | 
10 | The above copyright notice and this permission notice shall be included in all
11 | copies or substantial portions of the Software.
12 | 
13 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19 | THE SOFTWARE.
20 | 


--------------------------------------------------------------------------------
/bin/console:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env php
 2 | <?php
 3 | 
 4 | declare(strict_types=1);
 5 | 
 6 | use App\Command;
 7 | 
 8 | error_reporting(E_ALL);
 9 | ini_set('error_reporting', 'On');
10 | ini_set('display_errors', 'On');
11 | 
12 | require __DIR__ . '/../pre_init.php';
13 | 
14 | /**
15 |  * Throws an exception based on an error code.
16 |  *
17 |  * @param int $number The error code.
18 |  * @param mixed $error The error message.
19 |  * @param mixed $file The file where the error occurred.
20 |  * @param int $line The line number where the error occurred.
21 |  *
22 |  * @throws ErrorException When the error code is not suppressed by error_reporting.
23 |  */
24 | $errorHandler = function (int $number, mixed $error, mixed $file, int $line) {
25 |     $errno = $number & error_reporting();
26 |     if (0 === $errno) {
27 |         return;
28 |     }
29 | 
30 |     throw new ErrorException($error, $number, 1, $file, $line);
31 | };
32 | set_error_handler($errorHandler);
33 | 
34 | set_exception_handler(function (Throwable $e) {
35 |     $message = strtr('{kind}: {message} ({file}:{line}).', [
36 |             '{kind}' => $e::class,
37 |             '{line}' => $e->getLine(),
38 |             '{message}' => $e->getMessage(),
39 |             '{file}' => after($e->getFile(), ROOT_PATH),
40 |     ]);
41 | 
42 |     fwrite(STDERR, $message . PHP_EOL);
43 |     exit(502);
44 | });
45 | 
46 | if (!file_exists(__DIR__ . '/../vendor/autoload.php')) {
47 |     print 'Dependencies are missing please refer to https://github.com/arabcoders/watchstate/blob/master/FAQ.md';
48 |     exit(Command::FAILURE);
49 | }
50 | 
51 | require __DIR__ . '/../vendor/autoload.php';
52 | 
53 | try {
54 |     $app = new App\Libs\Initializer()->boot();
55 | } catch (Throwable $e) {
56 |     $message = strtr(
57 |             'CLI: Exception [{kind}] was thrown unhandled during CLI boot context. Error [{message} @ {file}:{line}].',
58 |             [
59 |                     '{kind}' => $e::class,
60 |                     '{line}' => $e->getLine(),
61 |                     '{message}' => $e->getMessage(),
62 |                     '{file}' => array_reverse(explode(ROOT_PATH, $e->getFile(), 2))[0],
63 |             ]
64 |     );
65 |     fwrite(STDERR, $message . PHP_EOL);
66 |     fwrite(STDERR, $e->getTraceAsString() . PHP_EOL);
67 |     exit(503);
68 | }
69 | 
70 | $app->console();
71 | 


--------------------------------------------------------------------------------
/config/Middlewares.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | use App\Libs\Middlewares\{AddCorsMiddleware,
 6 |     AddTimingMiddleware,
 7 |     AuthorizationMiddleware,
 8 |     NoAccessLogMiddleware,
 9 |     ParseJsonBodyMiddleware};
10 | 
11 | return static fn(): array => [
12 |     fn() => new AddTimingMiddleware(),
13 |     fn() => new AuthorizationMiddleware(),
14 |     fn() => new ParseJsonBodyMiddleware(),
15 |     fn() => new NoAccessLogMiddleware(),
16 |     fn() => new AddCorsMiddleware(),
17 | ];
18 | 


--------------------------------------------------------------------------------
/config/directories.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | return [
 6 |     '{path}/db/archive',
 7 |     '{path}/config',
 8 |     '{path}/backup',
 9 |     '{path}/users',
10 |     '{tmp_dir}/logs',
11 |     '{tmp_dir}/cache',
12 |     '{tmp_dir}/profiler',
13 |     '{tmp_dir}/webhooks',
14 |     '{tmp_dir}/debug',
15 | ];
16 | 


--------------------------------------------------------------------------------
/container/files/redis.conf:
--------------------------------------------------------------------------------
 1 | daemonize yes
 2 | 
 3 | pidfile /opt/redis.pid
 4 | bind 127.0.0.1
 5 | port 6379
 6 | 
 7 | # Logging
 8 | logfile ""
 9 | loglevel nothing
10 | 
11 | # Persistence
12 | dbfilename redis.rdb
13 | dir /config/cache/
14 | appendonly no
15 | appendfilename appendonly.aof
16 | save 900 1
17 | save 300 10
18 | save 60 10000
19 | 
20 | # Arbitrary Parameters
21 | maxmemory-policy allkeys-lru
22 | slowlog-log-slower-than 10000
23 | slowlog-max-len 128
24 | notify-keyspace-events ""
25 | 
26 | # Plan Properties:
27 | timeout 3600
28 | tcp-keepalive 60
29 | 


--------------------------------------------------------------------------------
/frontend/.gitignore:
--------------------------------------------------------------------------------
 1 | # Nuxt dev/build outputs
 2 | .output
 3 | .data
 4 | .nuxt
 5 | .nitro
 6 | .cache
 7 | dist
 8 | 
 9 | # Node dependencies
10 | node_modules
11 | 
12 | # Logs
13 | *.log
14 | 
15 | # Misc
16 | .DS_Store
17 | .fleet
18 | .idea
19 | 
20 | # Local env files
21 | .env
22 | .env.*
23 | !.env.example
24 | 


--------------------------------------------------------------------------------
/frontend/assets/webfonts/fa-brands-400.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/assets/webfonts/fa-brands-400.ttf


--------------------------------------------------------------------------------
/frontend/assets/webfonts/fa-brands-400.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/assets/webfonts/fa-brands-400.woff2


--------------------------------------------------------------------------------
/frontend/assets/webfonts/fa-regular-400.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/assets/webfonts/fa-regular-400.ttf


--------------------------------------------------------------------------------
/frontend/assets/webfonts/fa-regular-400.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/assets/webfonts/fa-regular-400.woff2


--------------------------------------------------------------------------------
/frontend/assets/webfonts/fa-solid-900.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/assets/webfonts/fa-solid-900.ttf


--------------------------------------------------------------------------------
/frontend/assets/webfonts/fa-solid-900.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/assets/webfonts/fa-solid-900.woff2


--------------------------------------------------------------------------------
/frontend/assets/webfonts/fa-v4compatibility.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/assets/webfonts/fa-v4compatibility.ttf


--------------------------------------------------------------------------------
/frontend/assets/webfonts/fa-v4compatibility.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/assets/webfonts/fa-v4compatibility.woff2


--------------------------------------------------------------------------------
/frontend/components/Message.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div class="notification" :class="message_class">
 3 |     <button class="delete" @click="$emit('close')" v-if="!useToggle && useClose"></button>
 4 |     <div @click="$emit('toggle')" class="is-clickable is-pulled-right is-unselectable" v-if="useToggle">
 5 |       <span class="icon">
 6 |         <i class="fas" :class="{'fa-arrow-up':toggle,'fa-arrow-down':!toggle}"></i>
 7 |       </span>
 8 |       <span>{{ toggle ? 'Close' : 'Open' }}</span>
 9 |     </div>
10 |     <div class="notification-title is-unselectable" :class="{'is-clickable':useToggle}" v-if="title || icon"
11 |          @click="useToggle ? $emit('toggle', toggle):null">
12 |       <template v-if="icon">
13 |         <span class="icon-text">
14 |           <span class="icon"><i :class="icon"></i></span>
15 |           <span>{{ title }}</span>
16 |         </span>
17 |       </template>
18 |       <template v-else>{{ title }}</template>
19 |     </div>
20 |     <div class="notification-content content is-text-break" v-if="false === useToggle || toggle">
21 |       <template v-if="message">{{ message }}</template>
22 |       <slot/>
23 |     </div>
24 |   </div>
25 | </template>
26 | 
27 | <script setup>
28 | defineProps({
29 |   title: {
30 |     type: String,
31 |     default: null,
32 |     required: false
33 |   },
34 |   icon: {
35 |     type: String,
36 |     default: null,
37 |     required: false
38 |   },
39 |   message: {
40 |     type: String,
41 |     default: null,
42 |     required: false
43 |   },
44 |   message_class: {
45 |     type: String,
46 |     default: 'is-info',
47 |     required: false
48 |   },
49 |   useToggle: {
50 |     type: Boolean,
51 |     default: false,
52 |     required: false
53 |   },
54 |   toggle: {
55 |     type: Boolean,
56 |     default: false,
57 |     required: false
58 |   },
59 |   useClose: {
60 |     type: Boolean,
61 |     default: false,
62 |     required: false
63 |   }
64 | })
65 | 
66 | defineEmits(['toggle', 'close'])
67 | </script>
68 | 


--------------------------------------------------------------------------------
/frontend/components/Overlay.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div class="modal is-active">
 3 |     <div class="modal-background" @click="closeOverLay()"></div>
 4 |     <div class="modal-card" style="min-width: calc(100% - 30%);">
 5 |       <header class="modal-card-head">
 6 |         <p class="modal-card-title" v-text="model_title"></p>
 7 |         <button class="delete" @click="closeOverLay"></button>
 8 |       </header>
 9 |       <div class="modal-card-body">
10 |         <slot />
11 |       </div>
12 |     </div>
13 |   </div>
14 | </template>
15 | 
16 | <script setup>
17 | const emit = defineEmits(['closeOverlay']);
18 | 
19 | const props = defineProps({
20 |   title: {
21 |     type: String,
22 |     required: true,
23 |   },
24 | });
25 | 
26 | const model_title = ref(props.title.replace(/^\//g, ''));
27 | 
28 | const closeOverLay = () => emit('closeOverlay');
29 | 
30 | const eventHandler = e => {
31 |   if (e.key !== 'Escape') {
32 |     return
33 |   }
34 |   closeOverLay()
35 | }
36 | 
37 | onMounted(() => {
38 |   disableOpacity()
39 |   window.addEventListener('keydown', eventHandler)
40 | })
41 | 
42 | onUnmounted(() => {
43 |   enableOpacity()
44 |   window.removeEventListener('keydown', eventHandler)
45 | })
46 | 
47 | </script>
48 | 


--------------------------------------------------------------------------------
/frontend/components/UserSelection.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div>
 3 |     <div class="field">
 4 |       <label class="label" for="user">Browse as</label>
 5 |       <div class="control has-icons-left">
 6 |         <div class="select is-fullwidth">
 7 |           <select v-model="api_user" class="is-capitalized" :disabled="isLoading">
 8 |             <option v-for="user in users" :key="'user-'+user" :value="user">
 9 |               {{ user }}
10 |             </option>
11 |           </select>
12 |         </div>
13 |         <div class="icon is-left">
14 |           <i class="fas fa-user"></i>
15 |         </div>
16 |       </div>
17 |       <p class="has-text-danger">
18 |         <span class="icon"><i class="fas fa-exclamation"/></span>
19 |         Browse the WebUI as the selected user. This feature is new and not all endpoints supports it yet, over time we
20 |         plan to add support for this feature to all endpoints. If the endpoint doesn't support this feature, the main
21 |         user will be used instead.
22 |       </p>
23 |     </div>
24 |     <div class="control has-text-right">
25 |       <button type="submit" class="button is-primary" :disabled="!api_user || isLoading" @click="reloadPage">
26 |         <span class="icon"><i class="fas fa-sync"/></span>
27 |         <span>Reload</span>
28 |       </button>
29 |     </div>
30 |   </div>
31 | </template>
32 | 
33 | <script setup>
34 | import {useStorage} from '@vueuse/core'
35 | import request from '~/utils/request'
36 | import {notification} from "~/utils/index.js";
37 | 
38 | const api_user = useStorage('api_user', 'main')
39 | const users = ref(['main'])
40 | const isLoading = ref(true)
41 | 
42 | 
43 | onMounted(async () => {
44 |   try {
45 |     isLoading.value = true
46 |     const response = await request('/system/users');
47 |     if (!response.ok) {
48 |       notification('error', 'Failed to fetch users.');
49 |       return;
50 |     }
51 |     const json = await response.json();
52 |     if ('users' in json) {
53 |       json.users.forEach(user => {
54 |         const username = user.user
55 |         if (!users.value.includes(username)) {
56 |           users.value.push(username);
57 |         }
58 |       });
59 |     }
60 |   } catch (e) {
61 |     notification('error', `Failed to fetch users. ${e}`);
62 |   } finally {
63 |     isLoading.value = false
64 |   }
65 | })
66 | 
67 | const reloadPage = () => window.location.reload()
68 | </script>
69 | 


--------------------------------------------------------------------------------
/frontend/composables/useToast.js:
--------------------------------------------------------------------------------
1 | import {useToast} from "vue-toastification";
2 | 
3 | export default () => useToast()
4 | 


--------------------------------------------------------------------------------
/frontend/error.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <NuxtLayout>
 3 |     <div class="columns is-multiline">
 4 |       <div class="column is-12">
 5 |         <h1 class="title is-4">
 6 | 
 7 |           {{ props.error.statusCode }}<span v-if="props.error.statusMessage"> - {{ props.error.statusMessage }}</span>
 8 |         </h1>
 9 |       </div>
10 |     </div>
11 |     <div class="column is-12" v-if="props.error.message">
12 |       <div class="notification has-background-warning-90 has-text-dark">
13 |         <p>{{ props.error.message }}</p>
14 |       </div>
15 |     </div>
16 | 
17 |     <div class="column is-12" v-if="props.error.stack">
18 |       <h2 class="title is-5 is-clickable" @click="showStacks = !showStacks">
19 |         <span class="icon-text">
20 |           <span class="icon">
21 |             <i v-if="showStacks" class="fas fa-arrow-up"></i>
22 |             <i v-else class="fas fa-arrow-down"></i>
23 |           </span>
24 |           <span>Stack trace</span>
25 |         </span>
26 |       </h2>
27 | 
28 |       <pre v-if="showStacks"><code>{{ props.error.stack }}</code></pre>
29 |     </div>
30 | 
31 |     <div class="column is-12">
32 |       <h2 class="title is-5">
33 |         <NuxtLink to="/">
34 |           <span class="icon-text">
35 |             <span class="icon"><i class="fas fa-home"></i></span>
36 |             <span>Back to Home</span>
37 |           </span>
38 |         </NuxtLink>
39 |       </h2>
40 |     </div>
41 |   </NuxtLayout>
42 | </template>
43 | 
44 | <script setup>
45 | const props = defineProps({'error': Object})
46 | const showStacks = ref(false)
47 | </script>
48 | 


--------------------------------------------------------------------------------
/frontend/layouts/guest.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <NuxtPage />
 3 | </template>
 4 | 
 5 | <script setup>
 6 | import 'assets/css/bulma.css'
 7 | import 'assets/css/style.css'
 8 | import 'assets/css/all.css'
 9 | </script>
10 | 


--------------------------------------------------------------------------------
/frontend/middleware/auth.global.js:
--------------------------------------------------------------------------------
 1 | import {storeToRefs} from 'pinia'
 2 | import {useAuthStore} from '~/store/auth'
 3 | import {useStorage} from '@vueuse/core'
 4 | 
 5 | let next_check = 0
 6 | 
 7 | export default defineNuxtRouteMiddleware(async to => {
 8 |     if (to.fullPath.startsWith('/auth') || to.fullPath.startsWith('/v1/api')) {
 9 |         return
10 |     }
11 | 
12 |     const {authenticated} = storeToRefs(useAuthStore())
13 |     const token = useStorage('token', null)
14 | 
15 |     if (token.value) {
16 |         if (Date.now() > next_check) {
17 |             console.debug('Validating user token...')
18 |             const {validate} = useAuthStore()
19 |             if (!await validate(token.value)) {
20 |                 token.value = null
21 |                 abortNavigation()
22 |                 console.error('Token is invalid, redirecting to login page...')
23 |                 return navigateTo('/auth')
24 |             }
25 |             console.debug('Token is valid.')
26 |             next_check = Date.now() + 1000 * 60 * 5
27 |         }
28 | 
29 |         authenticated.value = true
30 |     }
31 | 
32 |     if (!token.value && to?.name !== 'auth') {
33 |         abortNavigation()
34 |         return navigateTo('/auth')
35 |     }
36 | })
37 | 


--------------------------------------------------------------------------------
/frontend/nuxt.config.ts:
--------------------------------------------------------------------------------
 1 | // https://nuxt.com/docs/api/configuration/nuxt-config
 2 | 
 3 | import path from 'path'
 4 | 
 5 | let extraNitro = {}
 6 | try {
 7 |     const API_URL = import.meta.env.NUXT_API_URL;
 8 |     if (API_URL) {
 9 |         extraNitro = {
10 |             devProxy: {
11 |                 '/v1/api/': {
12 |                     target: API_URL + '/v1/api/',
13 |                     changeOrigin: true
14 |                 },
15 |                 '/guides/': {
16 |                     target: API_URL + '/guides/',
17 |                     changeOrigin: true
18 |                 },
19 |             }
20 |         }
21 |     }
22 | } catch (e) {
23 | }
24 | 
25 | export default defineNuxtConfig({
26 |     ssr: false,
27 |     devtools: {enabled: true},
28 | 
29 |     devServer: {
30 |         port: 8081,
31 |         host: "0.0.0.0",
32 |     },
33 |     runtimeConfig: {
34 |         public: {
35 |             domain: '/',
36 |             version: '1.0.0',
37 |         }
38 |     },
39 |     app: {
40 |         head: {
41 |             "meta": [
42 |                 {"charset": "utf-8"},
43 |                 {"name": "viewport", "content": "width=device-width, initial-scale=1.0, maximum-scale=1.0"},
44 |                 {"name": "theme-color", "content": "#000000"}
45 |             ],
46 |         },
47 |         buildAssetsDir: "assets",
48 |         pageTransition: {name: 'page', mode: 'out-in'}
49 |     },
50 | 
51 |     router: {
52 |         options: {
53 |             linkActiveClass: "is-selected",
54 |         }
55 |     },
56 | 
57 |     modules: [
58 |         '@vueuse/nuxt',
59 |         'floating-vue/nuxt',
60 |         '@pinia/nuxt',
61 |     ],
62 | 
63 |     nitro: {
64 |         output: {
65 |             publicDir: path.join(__dirname, 'exported')
66 |         },
67 |         ...extraNitro,
68 |     },
69 | 
70 |     build: {
71 |         transpile: ['vue-toastification'],
72 |     },
73 | 
74 |     css: [
75 |         'vue-toastification/dist/index.css'
76 |     ],
77 | 
78 |     telemetry: false,
79 |     compatibilityDate: "2024-12-28",
80 | })
81 | 


--------------------------------------------------------------------------------
/frontend/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "nuxt-app",
 3 |     "private": true,
 4 |     "type": "module",
 5 |     "scripts": {
 6 |         "build": "nuxt build",
 7 |         "dev": "nuxt dev",
 8 |         "generate": "nuxt generate",
 9 |         "preview": "nuxt preview",
10 |         "postinstall": "nuxt prepare"
11 |     },
12 |     "web-types": "./web-types.json",
13 |     "dependencies": {
14 |         "@microsoft/fetch-event-source": "^2.0.1",
15 |         "@pinia/nuxt": "^0.11.0",
16 |         "@vueuse/core": "^13.2.0",
17 |         "@vueuse/nuxt": "^13.2.0",
18 |         "@xterm/addon-fit": "^0.10.0",
19 |         "@xterm/xterm": "^5.5.0",
20 |         "cronstrue": "^2.61.0",
21 |         "floating-vue": "^5.2.2",
22 |         "hls.js": "^1.6.2",
23 |         "marked": "^15.0.12",
24 |         "marked-alert": "^2.1.2",
25 |         "marked-base-url": "^1.1.6",
26 |         "marked-gfm-heading-id": "^4.1.1",
27 |         "moment": "^2.30.1",
28 |         "nuxt": "^3.17.4",
29 |         "pinia": "^3.0.2",
30 |         "plyr": "^3.7.8",
31 |         "vue": "^3.5.14",
32 |         "vue-router": "^4.5.1",
33 |         "vue-toastification": "2.0.0-rc.5",
34 |         "vuedraggable": "^4.1.0"
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/frontend/pages/help/[...slug].vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div class="columns is-multiline" v-if="url">
 3 |     <div class="column is-12">
 4 |       <Markdown :file="url"/>
 5 |     </div>
 6 |   </div>
 7 | </template>
 8 | 
 9 | <script setup>
10 | const route = useRoute()
11 | const slug = ref(`${route.params.slug?.length > 0 ? route.params.slug.join('/') : ''}`)
12 | const url = ref('')
13 | onMounted(async () => {
14 |   const to_lower = String(slug.value).toLowerCase()
15 |   if (to_lower.includes('.md')) {
16 |     await navigateTo(to_lower.replace('.md', ''))
17 |   }
18 | 
19 |   const special = ['faq', 'readme', 'news']
20 | 
21 |   if (special.includes(to_lower)) {
22 |     url.value = '/guides/' + to_lower.toUpperCase() + '.md'
23 |     return
24 |   }
25 | 
26 |   url.value = '/guides/' + slug.value + '.md'
27 | 
28 |   if (route.query.title) {
29 |     useHead({title: `Guide - ${route.query.title}`})
30 |   }
31 | })
32 | </script>
33 | 


--------------------------------------------------------------------------------
/frontend/plugins/toast.js:
--------------------------------------------------------------------------------
 1 | import Toast from 'vue-toastification'
 2 | 
 3 | export default defineNuxtPlugin(nuxtApp => nuxtApp.vueApp.use(Toast, {
 4 |     transition: "Vue-Toastification__bounce",
 5 |     maxToasts: 5,
 6 |     closeOnClick: false,
 7 |     newestOnTop: true,
 8 |     showCloseButtonOnHover: true,
 9 | }))
10 | 


--------------------------------------------------------------------------------
/frontend/plugins/vuedraggable.client.js:
--------------------------------------------------------------------------------
1 | import draggable from 'vuedraggable'
2 | 
3 | export default defineNuxtPlugin((nuxtApp) => {
4 |     nuxtApp.vueApp.component('draggable', draggable)
5 | })
6 | 


--------------------------------------------------------------------------------
/frontend/public/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/public/favicon.ico


--------------------------------------------------------------------------------
/frontend/public/images/logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/frontend/public/images/logo.png


--------------------------------------------------------------------------------
/frontend/tsconfig.json:
--------------------------------------------------------------------------------
1 | {
2 |     // https://nuxt.com/docs/guide/concepts/typescript
3 |     "extends": "./.nuxt/tsconfig.json"
4 | }
5 | 


--------------------------------------------------------------------------------
/frontend/utils/awaiter.ts:
--------------------------------------------------------------------------------
 1 | const sleep = (ms: number) => new Promise(resolve => setTimeout(resolve, ms));
 2 | 
 3 | // for non arrays, length is undefined, so != 0
 4 | const isNotTruthy = (val: any) => val === undefined || val === false || val === null || val.length === 0;
 5 | 
 6 | /**
 7 |  * Waits for the test function to return a truthy value.
 8 |  *
 9 |  * @param test - The function to test
10 |  * @param timeout_ms - The maximum time to wait in milliseconds.
11 |  * @param frequency - The frequency to check the test function in milliseconds.
12 |  *
13 |  * @returns The result of the test function.
14 |  */
15 | export default async function awaiter(test: Function, timeout_ms: number = 20 * 1000, frequency: number = 200) {
16 |     if (typeof (test) != "function") {
17 |         throw new Error("test should be a function in awaiter(test, [timeout_ms], [frequency])")
18 |     }
19 | 
20 |     const endTime: number = Date.now() + timeout_ms;
21 | 
22 |     let result = test();
23 | 
24 |     while (isNotTruthy(result)) {
25 |         if (Date.now() > endTime) {
26 |             return false;
27 |         }
28 |         await sleep(frequency);
29 |         result = test();
30 |     }
31 | 
32 |     return result;
33 | }
34 | 
35 | 


--------------------------------------------------------------------------------
/frontend/utils/events/helpers.js:
--------------------------------------------------------------------------------
 1 | const makeName = id => id.replace(/-/g, '').slice(0, 12)
 2 | 
 3 | const getStatusClass = status => {
 4 |     switch (status) {
 5 |         case 0:
 6 |             return 'is-light has-text-dark'
 7 |         case 1:
 8 |             return 'is-warning'
 9 |         case 2:
10 |             return 'is-success'
11 |         case 3:
12 |             return 'is-danger'
13 |         case 4:
14 |             return 'is-danger is-light'
15 |         default:
16 |             return 'is-light has-text-dark'
17 |     }
18 | }
19 | 
20 | export {makeName, getStatusClass}
21 | 


--------------------------------------------------------------------------------
/frontend/utils/request.js:
--------------------------------------------------------------------------------
 1 | import { useStorage } from "@vueuse/core";
 2 | 
 3 | const token = useStorage('token', '')
 4 | const api_user = useStorage('api_user', 'main')
 5 | 
 6 | /**
 7 |  * Request content from the API. This function will automatically add the API token to the request headers.
 8 |  * And prefix the URL with the API URL and path.
 9 |  *
10 |  * @param url {string}
11 |  * @param options {RequestInit}
12 |  *
13 |  * @returns {Promise<Response>}
14 |  */
15 | export default async function request(url, options = {}) {
16 |     options = options || {};
17 |     options.method = options.method || 'GET';
18 |     options.headers = options.headers || {};
19 | 
20 |     if (options.headers['Authorization'] === undefined && token.value) {
21 |         options.headers['Authorization'] = 'Token ' + token.value;
22 |     }
23 | 
24 |     if (options.headers['Content-Type'] === undefined) {
25 |         options.headers['Content-Type'] = 'application/json';
26 |     }
27 | 
28 |     if (options.headers['Accept'] === undefined) {
29 |         options.headers['Accept'] = 'application/json';
30 |     }
31 | 
32 |     if (options.headers['X-User'] === undefined) {
33 |         options.headers['X-User'] = api_user.value;
34 |     }
35 | 
36 |     return fetch(`/v1/api${url}`, options);
37 | }
38 | 
39 | 


--------------------------------------------------------------------------------
/migrations/sqlite_1644418046_create_state_table.sql:
--------------------------------------------------------------------------------
 1 | -- # migrate_up
 2 | 
 3 | CREATE TABLE IF NOT EXISTS "state"
 4 | (
 5 |     "id"       integer NOT NULL PRIMARY KEY AUTOINCREMENT,
 6 |     "type"     text    NOT NULL,
 7 |     "updated"  integer NOT NULL,
 8 |     "watched"  integer NOT NULL DEFAULT '0',
 9 |     "via"      text    NOT NULL,
10 |     "title"    text    NOT NULL,
11 |     "year"     integer NULL,
12 |     "season"   integer NULL,
13 |     "episode"  integer NULL,
14 |     "parent"   text    NULL,
15 |     "guids"    text    NULL,
16 |     "metadata" text    NULL,
17 |     "extra"    text    NULL
18 | );
19 | 
20 | -- # migrate_down
21 | 
22 | DROP TABLE IF EXISTS "state";
23 | 


--------------------------------------------------------------------------------
/migrations/sqlite_1718473650_add_created_updated_at_fields.sql:
--------------------------------------------------------------------------------
 1 | -- # migrate_up
 2 | 
 3 | ALTER TABLE "state"
 4 |     ADD COLUMN "created_at" integer NOT NULL DEFAULT '0';
 5 | ALTER TABLE "state"
 6 |     ADD COLUMN "updated_at" integer NOT NULL DEFAULT '0';
 7 | UPDATE "state"
 8 | SET created_at = updated,
 9 |     updated_at = updated
10 | WHERE created_at = 0;
11 | CREATE INDEX IF NOT EXISTS "state_created_at" ON "state" (created_at);
12 | CREATE INDEX IF NOT EXISTS "state_updated_at" ON "state" (updated_at);
13 | 
14 | -- # migrate_down
15 | 
16 | ALTER TABLE "state"
17 |     DROP COLUMN "created_at";
18 | ALTER TABLE "state"
19 |     DROP COLUMN "updated_at";
20 | DROP INDEX IF EXISTS "state_created_at";
21 | DROP INDEX IF EXISTS "state_updated_at";
22 | 


--------------------------------------------------------------------------------
/migrations/sqlite_1723926051_add_events_table.sql:
--------------------------------------------------------------------------------
 1 | -- # migrate_up
 2 | 
 3 | CREATE TABLE `events`
 4 | (
 5 |     `id`         char(36)     NOT NULL,
 6 |     `status`     tinyint(1)   NOT NULL DEFAULT 0,
 7 |     `event`      varchar(255) NOT NULL,
 8 |     `event_data` longtext     NOT NULL DEFAULT '{}',
 9 |     `options`    longtext     NOT NULL DEFAULT '{}',
10 |     `attempts`   tinyint(1)   NOT NULL DEFAULT 0,
11 |     `logs`       longtext     NOT NULL DEFAULT '{}',
12 |     `created_at` datetime     NOT NULL,
13 |     `updated_at` datetime              DEFAULT NULL,
14 |     PRIMARY KEY (`id`)
15 | );
16 | 
17 | CREATE INDEX "events_event" ON "events" ("event");
18 | CREATE INDEX "events_status" ON "events" ("status");
19 | 
20 | -- # migrate_down
21 | 
22 | DROP TABLE IF EXISTS "events";
23 | 


--------------------------------------------------------------------------------
/migrations/sqlite_1723988129_add-reference-to-events.sql:
--------------------------------------------------------------------------------
 1 | -- # migrate_up
 2 | 
 3 | CREATE TABLE "_tmp_events"
 4 | (
 5 |     "id"         text    NOT NULL,
 6 |     "status"     integer NOT NULL DEFAULT '0',
 7 |     "reference"  text    NULL,
 8 |     "event"      text    NOT NULL,
 9 |     "event_data" text    NOT NULL DEFAULT '{}',
10 |     "options"    text    NOT NULL DEFAULT '{}',
11 |     "attempts"   integer NOT NULL DEFAULT '0',
12 |     "logs"       text    NOT NULL DEFAULT '{}',
13 |     "created_at" numeric NOT NULL,
14 |     "updated_at" numeric NULL,
15 |     PRIMARY KEY ("id")
16 | );
17 | 
18 | INSERT INTO "_tmp_events" ("id", "status", "event", "event_data", "options", "attempts", "logs", "created_at",
19 |                            "updated_at")
20 | SELECT "id",
21 |        "status",
22 |        "event",
23 |        "event_data",
24 |        "options",
25 |        "attempts",
26 |        "logs",
27 |        "created_at",
28 |        "updated_at"
29 | FROM "events";
30 | 
31 | DROP TABLE "events";
32 | ALTER TABLE "_tmp_events"
33 |     RENAME TO "events";
34 | CREATE INDEX "events_event" ON "events" ("event");
35 | CREATE INDEX "events_status" ON "events" ("status");
36 | CREATE INDEX "events_reference" ON "events" ("reference");
37 | 
38 | -- # migrate_down
39 | 
40 | CREATE TABLE "_tmp_events"
41 | (
42 |     "id"         text    NOT NULL,
43 |     "status"     integer NOT NULL DEFAULT '0',
44 |     "event"      text    NOT NULL,
45 |     "event_data" text    NOT NULL DEFAULT '{}',
46 |     "options"    text    NOT NULL DEFAULT '{}',
47 |     "attempts"   integer NOT NULL DEFAULT '0',
48 |     "logs"       text    NOT NULL DEFAULT '{}',
49 |     "created_at" numeric NOT NULL,
50 |     "updated_at" numeric NULL,
51 |     PRIMARY KEY ("id")
52 | );
53 | 
54 | INSERT INTO "_tmp_events" ("id", "status", "event", "event_data", "options", "attempts", "logs", "created_at",
55 |                            "updated_at")
56 | SELECT "id",
57 |        "status",
58 |        "event",
59 |        "event_data",
60 |        "options",
61 |        "attempts",
62 |        "logs",
63 |        "created_at",
64 |        "updated_at"
65 | FROM "events";
66 | 
67 | DROP TABLE "events";
68 | ALTER TABLE "_tmp_events"
69 |     RENAME TO "events";
70 | CREATE INDEX "events_event" ON "events" ("event");
71 | CREATE INDEX "events_status" ON "events" ("status");
72 | 
73 | -- put your downgrade database commands here.
74 | 


--------------------------------------------------------------------------------
/phpstan.neon:
--------------------------------------------------------------------------------
 1 | parameters:
 2 |     level: max
 3 |     bootstrapFiles:
 4 |         - ./pre_init.php
 5 |     excludePaths:
 6 |         - ./tests/*
 7 |         - ./vendor/*
 8 |         - ./data/*
 9 |         - ./public/*
10 |         - ./assets/*
11 |     fileExtensions:
12 |         - php
13 |     paths:
14 |         - ./src/
15 |         - ./config/
16 |         - ./bin/
17 |         - ./public/
18 |     ignoreErrors:
19 |         - '#iterable type (array|PDOStatement|iterable)#'
20 |         - '#Property (.+) \(string\) does not accept mixed.#'
21 |         - '#Cannot cast mixed to string.#'
22 |         - '#Parameter \#\d+ .+ of function .+ expects .+, mixed given.#'
23 |         - '#Method .+ should return .+ but returns mixed.#'
24 |         - '#Cannot access offset .+ on mixed.#'
25 |         - '#Cannot cast mixed to .+#'
26 |         - '#Argument of an invalid type mixed supplied for foreach, only iterables are supported.#'
27 |         - '#Parameter \#\d+ .+ of .+ expects .+, mixed given.#'
28 |         - '#Cannot access property .+ on mixed.#'
29 |         - '#set_error_handler#'
30 |         - '#Property .+ does not accept mixed.#'
31 |         - '#Function .+ should return .+ but returns mixed.#'
32 |         - '#Cannot call method .+ on mixed.#'
33 |         - '#Parameter .+ of class .+ expects .+, mixed given.#'
34 |         - '#Binary operation .+ between .+ and mixed results in an error.#'
35 | 


--------------------------------------------------------------------------------
/phpunit.xml.dist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 |          xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.5/phpunit.xsd" bootstrap="tests/bootstrap.php"
 4 |          colors="true">
 5 |     <testsuites>
 6 |         <testsuite name="WatchState Test Suite">
 7 |             <directory>tests</directory>
 8 |             <exclude>./tests/Mappers/Import.php</exclude>
 9 |         </testsuite>
10 |     </testsuites>
11 |     <logging/>
12 |     <source>
13 |         <include>
14 |             <directory suffix=".php">src</directory>
15 |         </include>
16 |         <exclude>
17 |             <directory>tests</directory>
18 |         </exclude>
19 |     </source>
20 | </phpunit>
21 | 


--------------------------------------------------------------------------------
/pre_init.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | if (!defined('APP_START')) {
 6 |     define('APP_START', microtime(true));
 7 | }
 8 | 
 9 | if (!defined('BASE_MEMORY')) {
10 |     define('BASE_MEMORY', memory_get_usage());
11 | }
12 | 
13 | if (!defined('BASE_PEAK_MEMORY')) {
14 |     define('BASE_PEAK_MEMORY', memory_get_peak_usage());
15 | }
16 | 
17 | if (!defined('ROOT_PATH')) {
18 |     define('ROOT_PATH', realpath(__DIR__));
19 | }
20 | 
21 | if (!defined('STDIN')) {
22 |     define('STDIN', fopen('php://stdin', 'rb'));
23 | }
24 | 
25 | if (!defined('STDOUT')) {
26 |     define('STDOUT', fopen('php://stdout', 'wb'));
27 | }
28 | 
29 | if (!defined('STDERR')) {
30 |     define('STDERR', fopen('php://stderr', 'wb'));
31 | }
32 | 


--------------------------------------------------------------------------------
/psalm.xml.dist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0"?>
 2 | <psalm errorLevel="4" resolveFromConfigFile="true" hideExternalErrors="true" ignoreInternalFunctionFalseReturn="false" autoloader="./pre_init.php">
 3 |     <projectFiles>
 4 |         <directory name="."/>
 5 |         <ignoreFiles allowMissingFiles="true">
 6 |             <directory name=".idea"/>
 7 |             <directory name="vendor"/>
 8 |             <directory name="assets"/>
 9 |             <directory name="frontend"/>
10 |             <directory name="docker"/>
11 |             <directory name="data"/>
12 |             <directory name="bin"/>
13 |         </ignoreFiles>
14 |     </projectFiles>
15 |     <extrasFiles>
16 |         <file name="./.phpstorm.meta.php"/>
17 |     </extrasFiles>
18 |     <issueHandlers>
19 |     </issueHandlers>
20 | </psalm>
21 | 


--------------------------------------------------------------------------------
/screenshots/add_backend.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/screenshots/add_backend.png


--------------------------------------------------------------------------------
/screenshots/index.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/screenshots/index.png


--------------------------------------------------------------------------------
/src/API/Backend/Discover.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backend;
 6 | 
 7 | use App\Backends\Plex\PlexClient;
 8 | use App\Libs\Attributes\Route\Get;
 9 | use App\Libs\Enums\Http\Status;
10 | use App\Libs\Exceptions\InvalidArgumentException;
11 | use App\Libs\Exceptions\RuntimeException;
12 | use App\Libs\Mappers\ImportInterface as iImport;
13 | use App\Libs\Options;
14 | use App\Libs\Traits\APITraits;
15 | use Psr\Http\Message\ResponseInterface as iResponse;
16 | use Psr\Http\Message\ServerRequestInterface as iRequest;
17 | use Psr\Log\LoggerInterface as iLogger;
18 | use Symfony\Contracts\HttpClient\HttpClientInterface as iHttp;
19 | use Throwable;
20 | 
21 | final class Discover
22 | {
23 |     use APITraits;
24 | 
25 |     #[Get(Index::URL . '/{name:backend}/discover[/]', name: 'backend.discover')]
26 |     public function __invoke(iRequest $request, string $name, iImport $mapper, iLogger $logger, iHttp $http): iResponse
27 |     {
28 |         try {
29 |             $userContext = $this->getUserContext($request, $mapper, $logger);
30 |         } catch (RuntimeException $e) {
31 |             return api_error($e->getMessage(), Status::NOT_FOUND);
32 |         }
33 | 
34 |         if (null === $this->getBackend(name: $name, userContext: $userContext)) {
35 |             return api_error(r("Backend '{name}' not found.", ['name' => $name]), Status::NOT_FOUND);
36 |         }
37 | 
38 |         try {
39 |             $client = $this->getClient(name: $name, userContext: $userContext);
40 | 
41 |             if (PlexClient::CLIENT_NAME !== $client->getType()) {
42 |                 return api_error('Discover is only available for Plex backends.', Status::BAD_REQUEST);
43 |             }
44 | 
45 |             assert($client instanceof PlexClient);
46 | 
47 |             $context = $client->getContext();
48 |             $opts = [];
49 | 
50 |             if (null !== ($adminToken = ag($context->options, Options::ADMIN_TOKEN))) {
51 |                 $opts[Options::ADMIN_TOKEN] = $adminToken;
52 |             }
53 | 
54 |             $list = $client::discover($http, $context->backendToken, $opts);
55 |             return api_response(Status::OK, ag($list, 'list', []));
56 |         } catch (InvalidArgumentException $e) {
57 |             return api_error($e->getMessage(), Status::NOT_FOUND);
58 |         } catch (Throwable $e) {
59 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
60 |         }
61 |     }
62 | }
63 | 


--------------------------------------------------------------------------------
/src/API/Backend/Index.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backend;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Enums\Http\Status;
 9 | use App\Libs\Exceptions\RuntimeException;
10 | use App\Libs\Mappers\ImportInterface as iImport;
11 | use App\Libs\Traits\APITraits;
12 | use Psr\Http\Message\ResponseInterface as iResponse;
13 | use Psr\Http\Message\ServerRequestInterface as iRequest;
14 | use Psr\Log\LoggerInterface as iLogger;
15 | 
16 | final class Index
17 | {
18 |     use APITraits;
19 | 
20 |     public const string URL = '%{api.prefix}/backend';
21 | 
22 |     #[Get(self::URL . '/{name:backend}[/]', name: 'backend.view')]
23 |     public function __invoke(iRequest $request, string $name, iImport $mapper, iLogger $logger): iResponse
24 |     {
25 |         try {
26 |             $userContext = $this->getUserContext($request, $mapper, $logger);
27 |         } catch (RuntimeException $e) {
28 |             return api_error($e->getMessage(), Status::NOT_FOUND);
29 |         }
30 | 
31 |         if (null === ($data = $this->getBackend(name: $name, userContext: $userContext))) {
32 |             return api_error(r("Backend '{name}' not found.", ['name' => $name]), Status::NOT_FOUND);
33 |         }
34 | 
35 |         return api_response(Status::OK, $data);
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/API/Backend/Info.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backend;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\DataUtil;
 9 | use App\Libs\Enums\Http\Status;
10 | use App\Libs\Exceptions\InvalidArgumentException;
11 | use App\Libs\Exceptions\RuntimeException;
12 | use App\Libs\Mappers\ImportInterface as iImport;
13 | use App\Libs\Options;
14 | use App\Libs\Traits\APITraits;
15 | use Psr\Http\Message\ResponseInterface as iResponse;
16 | use Psr\Http\Message\ServerRequestInterface as iRequest;
17 | use Psr\Log\LoggerInterface as iLogger;
18 | use Throwable;
19 | 
20 | final class Info
21 | {
22 |     use APITraits;
23 | 
24 |     #[Get(Index::URL . '/{name:backend}/info[/]', name: 'backend.info')]
25 |     public function __invoke(iRequest $request, string $name, iImport $mapper, iLogger $logger): iResponse
26 |     {
27 |         try {
28 |             $userContext = $this->getUserContext($request, $mapper, $logger);
29 |         } catch (RuntimeException $e) {
30 |             return api_error($e->getMessage(), Status::NOT_FOUND);
31 |         }
32 | 
33 |         if (null === $this->getBackend(name: $name, userContext: $userContext)) {
34 |             return api_error(r("Backend '{name}' not found.", ['name' => $name]), Status::NOT_FOUND);
35 |         }
36 | 
37 |         try {
38 |             $client = $this->getClient(name: $name, userContext: $userContext);
39 |         } catch (InvalidArgumentException $e) {
40 |             return api_error($e->getMessage(), Status::NOT_FOUND);
41 |         }
42 | 
43 |         $opts = [];
44 |         $params = DataUtil::fromRequest($request, true);
45 | 
46 |         if (true === (bool)$params->get('raw', false)) {
47 |             $opts[Options::RAW_RESPONSE] = true;
48 |         }
49 | 
50 |         try {
51 |             $data = $client->getInfo($opts);
52 |             return api_response(Status::OK, $data);
53 |         } catch (Throwable $e) {
54 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
55 |         }
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/src/API/Backend/Sessions.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backend;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\DataUtil;
 9 | use App\Libs\Enums\Http\Status;
10 | use App\Libs\Exceptions\InvalidArgumentException;
11 | use App\Libs\Exceptions\RuntimeException;
12 | use App\Libs\Mappers\ImportInterface as iImport;
13 | use App\Libs\Options;
14 | use App\Libs\Traits\APITraits;
15 | use Psr\Http\Message\ResponseInterface as iResponse;
16 | use Psr\Http\Message\ServerRequestInterface as iRequest;
17 | use Psr\Log\LoggerInterface as iLogger;
18 | use Throwable;
19 | 
20 | final class Sessions
21 | {
22 |     use APITraits;
23 | 
24 |     #[Get(Index::URL . '/{name:backend}/sessions[/]', name: 'backend.sessions')]
25 |     public function __invoke(iRequest $request, string $name, iImport $mapper, iLogger $logger): iResponse
26 |     {
27 |         try {
28 |             $userContext = $this->getUserContext($request, $mapper, $logger);
29 |         } catch (RuntimeException $e) {
30 |             return api_error($e->getMessage(), Status::NOT_FOUND);
31 |         }
32 | 
33 |         if (null === $this->getBackend(name: $name, userContext: $userContext)) {
34 |             return api_error(r("Backend '{name}' not found.", ['name' => $name]), Status::NOT_FOUND);
35 |         }
36 | 
37 |         try {
38 |             $client = $this->getClient(name: $name, userContext: $userContext);
39 |         } catch (InvalidArgumentException $e) {
40 |             return api_error($e->getMessage(), Status::NOT_FOUND);
41 |         }
42 | 
43 |         $opts = [];
44 |         $params = DataUtil::fromRequest($request, true);
45 | 
46 |         if (true === (bool)$params->get('raw', false)) {
47 |             $opts[Options::RAW_RESPONSE] = true;
48 |         }
49 | 
50 |         try {
51 |             $sessions = $client->getSessions($opts);
52 |             return api_response(Status::OK, ag($sessions, 'sessions', []));
53 |         } catch (Throwable $e) {
54 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
55 |         }
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/src/API/Backend/Users.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backend;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\DataUtil;
 9 | use App\Libs\Enums\Http\Status;
10 | use App\Libs\Exceptions\InvalidArgumentException;
11 | use App\Libs\Exceptions\RuntimeException;
12 | use App\Libs\Mappers\ImportInterface as iImport;
13 | use App\Libs\Options;
14 | use App\Libs\Traits\APITraits;
15 | use Psr\Http\Message\ResponseInterface as iResponse;
16 | use Psr\Http\Message\ServerRequestInterface as iRequest;
17 | use Psr\Log\LoggerInterface as iLogger;
18 | use Throwable;
19 | 
20 | final class Users
21 | {
22 |     use APITraits;
23 | 
24 |     #[Get(Index::URL . '/{name:backend}/users[/]', name: 'backend.users')]
25 |     public function __invoke(iRequest $request, string $name, iImport $mapper, iLogger $logger): iResponse
26 |     {
27 |         try {
28 |             $userContext = $this->getUserContext($request, $mapper, $logger);
29 |         } catch (RuntimeException $e) {
30 |             return api_error($e->getMessage(), Status::NOT_FOUND);
31 |         }
32 | 
33 |         if (null === $this->getBackend(name: $name, userContext: $userContext)) {
34 |             return api_error(r("Backend '{name}' not found.", ['name' => $name]), Status::NOT_FOUND);
35 |         }
36 | 
37 |         $opts = [];
38 |         $params = DataUtil::fromRequest($request, true);
39 | 
40 |         if (true === (bool)$params->get('tokens', false)) {
41 |             $opts['tokens'] = true;
42 |         }
43 | 
44 |         if (true === (bool)$params->get('raw', false)) {
45 |             $opts[Options::RAW_RESPONSE] = true;
46 |         }
47 | 
48 |         try {
49 |             return api_response(
50 |                 Status::OK,
51 |                 $this->getClient(name: $name, userContext: $userContext)->getUsersList($opts)
52 |             );
53 |         } catch (InvalidArgumentException $e) {
54 |             return api_error($e->getMessage(), Status::NOT_FOUND);
55 |         } catch (Throwable $e) {
56 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
57 |         }
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/src/API/Backend/Version.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backend;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Enums\Http\Status;
 9 | use App\Libs\Exceptions\InvalidArgumentException;
10 | use App\Libs\Exceptions\RuntimeException;
11 | use App\Libs\Mappers\ImportInterface as iImport;
12 | use App\Libs\Traits\APITraits;
13 | use Psr\Http\Message\ResponseInterface as iResponse;
14 | use Psr\Http\Message\ServerRequestInterface as iRequest;
15 | use Psr\Log\LoggerInterface as iLogger;
16 | use Throwable;
17 | 
18 | final class Version
19 | {
20 |     use APITraits;
21 | 
22 |     #[Get(Index::URL . '/{name:backend}/version[/]', name: 'backend.version')]
23 |     public function __invoke(iRequest $request, string $name, iImport $mapper, iLogger $logger): iResponse
24 |     {
25 |         try {
26 |             $userContext = $this->getUserContext($request, $mapper, $logger);
27 |         } catch (RuntimeException $e) {
28 |             return api_error($e->getMessage(), Status::NOT_FOUND);
29 |         }
30 | 
31 |         if (null === $this->getBackend(name: $name, userContext: $userContext)) {
32 |             return api_error(r("Backend '{name}' not found.", ['name' => $name]), Status::NOT_FOUND);
33 |         }
34 | 
35 |         try {
36 |             return api_response(Status::OK, [
37 |                 'version' => $this->getClient(name: $name, userContext: $userContext)->getVersion()
38 |             ]);
39 |         } catch (InvalidArgumentException $e) {
40 |             return api_error($e->getMessage(), Status::NOT_FOUND);
41 |         } catch (Throwable $e) {
42 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
43 |         }
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/API/Backends/AccessToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backends;
 6 | 
 7 | use App\Libs\Attributes\Route\Post;
 8 | use App\Libs\DataUtil;
 9 | use App\Libs\Enums\Http\Status;
10 | use App\Libs\Exceptions\InvalidArgumentException;
11 | use App\Libs\Traits\APITraits;
12 | use Psr\Http\Message\ResponseInterface as iResponse;
13 | use Psr\Http\Message\ServerRequestInterface as iRequest;
14 | use Throwable;
15 | 
16 | final class AccessToken
17 | {
18 |     use APITraits;
19 | 
20 |     public const string URL = Index::URL . '/accesstoken';
21 | 
22 |     #[Post(self::URL . '/{type}[/]', name: 'backends.get.accesstoken')]
23 |     public function __invoke(iRequest $request, array $args = []): iResponse
24 |     {
25 |         if (null === ($type = ag($args, 'type'))) {
26 |             return api_error('Invalid value for type path parameter.', Status::BAD_REQUEST);
27 |         }
28 | 
29 |         $params = DataUtil::fromRequest($request);
30 |         $username = $params->get('username');
31 |         $password = $params->get('password');
32 | 
33 |         if (empty($username) || empty($password)) {
34 |             return api_error('Invalid username or password.', Status::BAD_REQUEST);
35 |         }
36 | 
37 |         if (false === in_array($type, ['jellyfin', 'emby'])) {
38 |             return api_error('Access token endpoint only supported on jellyfin, emby.', Status::BAD_REQUEST);
39 |         }
40 | 
41 |         try {
42 |             $client = $this->getBasicClient($type, $params->with('token', 'accesstoken_request'));
43 |         } catch (InvalidArgumentException $e) {
44 |             return api_error($e->getMessage(), Status::BAD_REQUEST);
45 |         }
46 | 
47 |         try {
48 |             $info = $client->generateAccessToken($username, $password);
49 |         } catch (Throwable $e) {
50 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
51 |         }
52 | 
53 |         return api_response(Status::OK, $info);
54 |     }
55 | }
56 | 


--------------------------------------------------------------------------------
/src/API/Backends/Discover.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backends;
 6 | 
 7 | use App\Backends\Plex\PlexClient;
 8 | use App\Libs\Attributes\Route\Route;
 9 | use App\Libs\DataUtil;
10 | use App\Libs\Enums\Http\Status;
11 | use App\Libs\Exceptions\InvalidArgumentException;
12 | use App\Libs\Options;
13 | use App\Libs\Traits\APITraits;
14 | use Psr\Http\Message\ResponseInterface as iResponse;
15 | use Psr\Http\Message\ServerRequestInterface as iRequest;
16 | use Symfony\Contracts\HttpClient\HttpClientInterface as iHttp;
17 | use Throwable;
18 | 
19 | final class Discover
20 | {
21 |     use APITraits;
22 | 
23 |     public function __construct(private readonly iHttp $http)
24 |     {
25 |     }
26 | 
27 |     #[Route(['GET', 'POST'], Index::URL . '/discover/{type}[/]', name: 'backends.get.users')]
28 |     public function __invoke(iRequest $request, array $args = []): iResponse
29 |     {
30 |         if (null === ($type = ag($args, 'type'))) {
31 |             return api_error('Invalid value for type path parameter.', Status::BAD_REQUEST);
32 |         }
33 | 
34 |         if ('plex' !== $type) {
35 |             return api_error('Discover only supported on plex.', Status::BAD_REQUEST);
36 |         }
37 | 
38 |         try {
39 |             $client = $this->getBasicClient($type, DataUtil::fromRequest($request, true));
40 |             assert($client instanceof PlexClient);
41 |         } catch (InvalidArgumentException $e) {
42 |             return api_error($e->getMessage(), Status::BAD_REQUEST);
43 |         }
44 | 
45 |         try {
46 |             $opts = [];
47 | 
48 |             if (null !== ($adminToken = ag($request->getParsedBody(), 'options.' . Options::ADMIN_TOKEN))) {
49 |                 $opts[Options::ADMIN_TOKEN] = $adminToken;
50 |             }
51 | 
52 |             $list = $client::discover($this->http, $client->getContext()->backendToken, $opts);
53 |             return api_response(Status::OK, ag($list, 'list', []));
54 |         } catch (Throwable $e) {
55 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
56 |         }
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/src/API/Backends/Index.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backends;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Enums\Http\Status;
 9 | use App\Libs\Mappers\ImportInterface as iImport;
10 | use App\Libs\Options;
11 | use App\Libs\Traits\APITraits;
12 | use Psr\Http\Message\ResponseInterface as iResponse;
13 | use Psr\Http\Message\ServerRequestInterface as iRequest;
14 | use Psr\Log\LoggerInterface as iLogger;
15 | 
16 | final class Index
17 | {
18 |     use APITraits;
19 | 
20 |     public const string URL = '%{api.prefix}/backends';
21 | 
22 |     public const array BLACK_LIST = [
23 |         'token',
24 |         'webhook.token',
25 |         'options.' . Options::ADMIN_TOKEN,
26 |         'options.' . Options::PLEX_USER_PIN,
27 |     ];
28 | 
29 |     #[Get(self::URL . '[/]', name: 'backends')]
30 |     public function __invoke(iRequest $request, iImport $mapper, iLogger $logger): iResponse
31 |     {
32 |         $list = [];
33 |         $user = $this->getUserContext($request, $mapper, $logger);
34 | 
35 |         foreach ($this->getBackends(userContext: $user) as $backend) {
36 |             if (!$request->getAttribute(Options::INTERNAL_REQUEST)) {
37 |                 $item = array_filter(
38 |                     $backend,
39 |                     fn ($key) => false === in_array($key, ['options', 'webhook'], true),
40 |                     ARRAY_FILTER_USE_KEY
41 |                 );
42 | 
43 |                 $item = ag_set(
44 |                     $item,
45 |                     'options.' . Options::IMPORT_METADATA_ONLY,
46 |                     (bool)ag($backend, 'options.' . Options::IMPORT_METADATA_ONLY, false)
47 |                 );
48 |                 $list[] = $item;
49 |                 continue;
50 |             }
51 | 
52 |             $list[] = $backend;
53 |         }
54 | 
55 |         return api_response(Status::OK, $list);
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/src/API/Backends/Spec.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backends;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Enums\Http\Status;
 9 | use App\Libs\Traits\APITraits;
10 | use Psr\Http\Message\ResponseInterface as iResponse;
11 | use Psr\Http\Message\ServerRequestInterface as iRequest;
12 | 
13 | final class Spec
14 | {
15 |     use APITraits;
16 | 
17 |     #[Get(Index::URL . '/spec[/]', name: 'backends.spec')]
18 |     public function __invoke(iRequest $request, array $args = []): iResponse
19 |     {
20 |         $specs = require __DIR__ . '/../../../config/servers.spec.php';
21 | 
22 |         $list = [];
23 | 
24 |         foreach ($specs as $spec) {
25 |             $item = [
26 |                 'key' => $spec['key'],
27 |                 'type' => $spec['type'],
28 |                 'description' => $spec['description'],
29 |             ];
30 | 
31 |             if (ag_exists($spec, 'choices')) {
32 |                 $item['choices'] = $spec['choices'];
33 |             }
34 | 
35 |             $list[] = $item;
36 |         }
37 | 
38 |         return api_response(Status::OK, $list);
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/API/Backends/UUid.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backends;
 6 | 
 7 | use App\Libs\Attributes\Route\Route;
 8 | use App\Libs\DataUtil;
 9 | use App\Libs\Enums\Http\Status;
10 | use App\Libs\Exceptions\InvalidArgumentException;
11 | use App\Libs\Traits\APITraits;
12 | use Psr\Http\Message\ResponseInterface as iResponse;
13 | use Psr\Http\Message\ServerRequestInterface as iRequest;
14 | 
15 | final class UUid
16 | {
17 |     use APITraits;
18 | 
19 |     #[Route(['GET', 'POST'], Index::URL . '/uuid/{type}[/]', name: 'backends.get.unique_id')]
20 |     public function __invoke(iRequest $request, array $args = []): iResponse
21 |     {
22 |         if (null === ($type = ag($args, 'type'))) {
23 |             return api_error('Invalid value for type path parameter.', Status::BAD_REQUEST);
24 |         }
25 | 
26 |         try {
27 |             $client = $this->getBasicClient($type, DataUtil::fromRequest($request, true));
28 | 
29 |             $info = $client->getInfo();
30 | 
31 |             return api_response(Status::OK, [
32 |                 'type' => strtolower((string)ag($info, 'type')),
33 |                 'identifier' => ag($info, 'identifier'),
34 |             ]);
35 |         } catch (InvalidArgumentException $e) {
36 |             return api_error($e->getMessage(), Status::BAD_REQUEST);
37 |         } catch (\Throwable $e) {
38 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
39 |         }
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/API/Backends/Users.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backends;
 6 | 
 7 | use App\Libs\Attributes\Route\Route;
 8 | use App\Libs\DataUtil;
 9 | use App\Libs\Enums\Http\Status;
10 | use App\Libs\Exceptions\InvalidArgumentException;
11 | use App\Libs\Options;
12 | use App\Libs\Traits\APITraits;
13 | use Psr\Http\Message\ResponseInterface as iResponse;
14 | use Psr\Http\Message\ServerRequestInterface as iRequest;
15 | use Psr\Log\LoggerInterface as iLogger;
16 | use Throwable;
17 | 
18 | final class Users
19 | {
20 |     use APITraits;
21 | 
22 |     #[Route(['GET', 'POST'], Index::URL . '/users/{type}[/]', name: 'backends.get.backend.users')]
23 |     public function __invoke(iRequest $request, string $type, iLogger $logger): iResponse
24 |     {
25 |         $params = DataUtil::fromRequest($request, true);
26 | 
27 |         try {
28 |             $client = $this->getBasicClient($type, $params);
29 |         } catch (InvalidArgumentException $e) {
30 |             return api_error($e->getMessage(), Status::BAD_REQUEST);
31 |         }
32 | 
33 |         $users = $opts = [];
34 | 
35 |         if (true === (bool)$params->get(Options::GET_TOKENS, false)) {
36 |             $opts[Options::GET_TOKENS] = true;
37 |         }
38 | 
39 |         if (true === (bool)$params->get('no_cache', false)) {
40 |             $opts[Options::NO_CACHE] = true;
41 |         }
42 | 
43 |         try {
44 |             foreach ($client->getUsersList($opts) as $user) {
45 |                 $users[] = $user;
46 |             }
47 |         } catch (Throwable $e) {
48 |             $logger->error($e->getMessage(), $e->getTrace());
49 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
50 |         }
51 | 
52 |         return api_response(Status::OK, $users);
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/src/API/Backends/ValidateToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Backends;
 6 | 
 7 | use App\Backends\Plex\PlexClient;
 8 | use App\Libs\Attributes\Route\Route;
 9 | use App\Libs\DataUtil;
10 | use App\Libs\Enums\Http\Status;
11 | use App\Libs\Traits\APITraits;
12 | use Psr\Http\Message\ResponseInterface as iResponse;
13 | use Psr\Http\Message\ServerRequestInterface as iRequest;
14 | use Symfony\Contracts\HttpClient\HttpClientInterface as iHttp;
15 | use Throwable;
16 | 
17 | final class ValidateToken
18 | {
19 |     use APITraits;
20 | 
21 |     #[Route(['POST'], Index::URL . '/validate/token/{type}[/]', name: 'backends.validate.token')]
22 |     public function __invoke(iRequest $request, iHttp $http, string $type): iResponse
23 |     {
24 |         if (false === (ucfirst($type) === PlexClient::CLIENT_NAME)) {
25 |             return api_error('Validate token api endpoint only supported for plex client.', Status::BAD_REQUEST);
26 |         }
27 | 
28 |         $params = DataUtil::fromRequest($request);
29 | 
30 |         if (null === ($token = $params->get('token'))) {
31 |             return api_error('Token is required.', Status::BAD_REQUEST);
32 |         }
33 | 
34 |         try {
35 |             $status = PlexClient::validate_token($http, $token);
36 | 
37 |             if (true === $status) {
38 |                 return api_message('Token is valid.', Status::OK);
39 |             }
40 | 
41 |             return api_error('non 200 OK request received.', Status::UNAUTHORIZED);
42 |         } catch (Throwable $e) {
43 |             return api_error($e->getMessage(), Status::tryFrom($e->getCode()) ?? Status::BAD_REQUEST);
44 |         }
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/API/Player/Index.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\Player;
 6 | 
 7 | final readonly class Index
 8 | {
 9 |     public const string URL = '%{api.prefix}/player';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/API/System/Cache.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Delete;
 8 | use App\Libs\Enums\Http\Status;
 9 | use Psr\Http\Message\ResponseInterface as iResponse;
10 | use Redis;
11 | use RedisException;
12 | 
13 | final class Cache
14 | {
15 |     public const string URL = '%{api.prefix}/system/cache';
16 | 
17 |     #[Delete(self::URL . '[/]', name: 'system.cache')]
18 |     public function purge_cache(Redis $redis): iResponse
19 |     {
20 |         try {
21 |             $status = $redis->flushDB(true);
22 |         } catch (RedisException $e) {
23 |             return api_error($e->getMessage(), Status::INTERNAL_SERVER_ERROR);
24 |         }
25 | 
26 |         return api_message(
27 |             $status ? 'Cache purged successfully.' : 'Failed to purge cache.',
28 |             $status ? Status::OK : Status::INTERNAL_SERVER_ERROR
29 |         );
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/API/System/Explode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Exceptions\RuntimeException;
 9 | use Psr\Http\Message\ResponseInterface as iResponse;
10 | 
11 | final readonly class Explode
12 | {
13 |     public const string URL = '%{api.prefix}/system/explode';
14 | 
15 |     #[Get(self::URL . '[/]', name: 'system.explode')]
16 |     public function __invoke(): iResponse
17 |     {
18 |         throw new RuntimeException('Throwing an exception to test exception handling.');
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/API/System/HealthCheck.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Enums\Http\Status;
 9 | use Psr\Http\Message\ResponseInterface as iResponse;
10 | use Psr\Http\Message\ServerRequestInterface as iRequest;
11 | 
12 | final class HealthCheck
13 | {
14 |     public const string URL = '%{api.prefix}/system/healthcheck';
15 | 
16 |     #[Get(self::URL . '[/]', name: 'system.healthcheck')]
17 |     public function __invoke(iRequest $request): iResponse
18 |     {
19 |         return api_response(Status::OK, [
20 |             'status' => 'ok',
21 |             'message' => 'System is healthy',
22 |         ], headers: ['X-No-AccessLog' => '1']);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/API/System/Report.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Enums\Http\Status;
 9 | use Psr\Http\Message\ResponseInterface as iResponse;
10 | 
11 | final class Report
12 | {
13 |     public const string URL = '%{api.prefix}/system/report';
14 | 
15 |     #[Get(self::URL . '[/]', name: 'system.report')]
16 |     public function basic_report(): iResponse
17 |     {
18 |         return api_response(Status::OK, runCommand('system:report', asArray: true));
19 |     }
20 | 
21 |     #[Get(self::URL . '/ini[/]', name: 'system.ini')]
22 |     public function php_ini(): iResponse
23 |     {
24 |         if (false === str_starts_with(getAppVersion(), 'dev')) {
25 |             return api_error('This endpoint is only available in development mode.', Status::FORBIDDEN);
26 |         }
27 | 
28 |         return api_response(Status::OK, ['content' => ini_get_all()]);
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/API/System/Reset.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Delete;
 8 | use App\Libs\Enums\Http\Status;
 9 | use App\Libs\Mappers\ImportInterface as iImport;
10 | use Psr\Http\Message\ResponseInterface as iResponse;
11 | use Psr\Http\Message\ServerRequestInterface as iRequest;
12 | use Psr\Log\LoggerInterface as iLogger;
13 | use Redis;
14 | use RedisException;
15 | 
16 | final class Reset
17 | {
18 |     public const string URL = '%{api.prefix}/system/reset';
19 | 
20 |     #[Delete(self::URL . '[/]', name: 'system.reset')]
21 |     public function __invoke(iRequest $request, Redis $redis, iImport $mapper, iLogger $logger): iResponse
22 |     {
23 |         foreach (getUsersContext($mapper, $logger) as $userContext) {
24 |             // -- reset database.
25 |             $userContext->db->reset();
26 | 
27 |             // -- reset last import/export date.
28 |             foreach (array_keys($userContext->config->getAll()) as $name) {
29 |                 $userContext->config->set("{$name}.import.lastSync", null);
30 |                 $userContext->config->set("{$name}.export.lastSync", null);
31 |             }
32 | 
33 |             // -- persist changes.
34 |             $userContext->config->persist(true);
35 |         }
36 | 
37 |         // -- reset cache data.
38 |         try {
39 |             $redis->flushDB();
40 |         } catch (RedisException) {
41 |         }
42 | 
43 |         return api_response(Status::OK, ['message' => 'System reset is complete.']);
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/API/System/Scheduler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Attributes\Route\Post;
 9 | use App\Libs\Enums\Http\Status;
10 | use Psr\Http\Message\ResponseInterface as iResponse;
11 | 
12 | final class Scheduler
13 | {
14 |     public const string URL = '%{api.prefix}/system/scheduler';
15 | 
16 |     #[Get(self::URL . '[/]', name: 'system.task_scheduler.status')]
17 |     public function status(): iResponse
18 |     {
19 |         return api_response(Status::OK, isSchedulerRunning(ignoreContainer: true), headers: [
20 |             'X-No-AccessLog' => '1',
21 |         ]);
22 |     }
23 | 
24 |     #[Post(self::URL . '/restart[/]', name: 'system.task_scheduler.restart')]
25 |     public function restart(): iResponse
26 |     {
27 |         if (true === (bool)env('DISABLE_CRON', false)) {
28 |             return api_error(
29 |                 "Task scheduler is disabled via 'DISABLE_CRON' environment variable.",
30 |                 Status::BAD_REQUEST
31 |             );
32 |         }
33 | 
34 |         if (!inContainer()) {
35 |             return api_error('WatchState is not running in a container.', Status::BAD_REQUEST);
36 |         }
37 | 
38 |         return api_response(Status::OK, restartScheduler());
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/API/System/Supported.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Config;
 9 | use App\Libs\Enums\Http\Status;
10 | use Psr\Http\Message\ResponseInterface as iResponse;
11 | use Psr\Http\Message\ServerRequestInterface as iRequest;
12 | 
13 | final class Supported
14 | {
15 |     public const string URL = '%{api.prefix}/system/supported';
16 | 
17 |     #[Get(self::URL . '[/]', name: 'system.supported')]
18 |     public function __invoke(iRequest $request): iResponse
19 |     {
20 |         return api_response(Status::OK, array_keys(Config::get('supported')));
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/API/System/ToYaml.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Post;
 8 | use App\Libs\Config;
 9 | use App\Libs\DataUtil;
10 | use App\Libs\Enums\Http\Status;
11 | use App\Libs\Stream;
12 | use Psr\Http\Message\ResponseInterface as iResponse;
13 | use Psr\Http\Message\ServerRequestInterface as iRequest;
14 | use Symfony\Component\Yaml\Exception\DumpException;
15 | use Symfony\Component\Yaml\Yaml;
16 | 
17 | final readonly class ToYaml
18 | {
19 |     public const string URL = '%{api.prefix}/system/yaml';
20 | 
21 |     #[Post(self::URL . '[/[{filename}[/]]]', name: 'system.to_yaml')]
22 |     public function __invoke(iRequest $request, string|null $filename = null): iResponse
23 |     {
24 |         $params = DataUtil::fromArray($request->getQueryParams());
25 |         try {
26 |             $stream = Stream::create(Yaml::dump(
27 |                 input: $request->getParsedBody(),
28 |                 inline: (int)$params->get('inline', 4),
29 |                 indent: (int)$params->get('indent', 2),
30 |                 flags: Yaml::DUMP_OBJECT | Yaml::DUMP_OBJECT_AS_MAP | Yaml::DUMP_MULTI_LINE_LITERAL_BLOCK
31 |             ));
32 |         } catch (DumpException $e) {
33 |             return api_error(r("Failed to convert to yaml. '{error}'.", ['error' => $e->getMessage()]), Status::BAD_REQUEST);
34 |         }
35 | 
36 |         return api_response(Status::OK, body:$stream, headers: [
37 |             'Content-Type' => 'text/yaml',
38 |             'Content-Disposition' => r('{mode}; filename="{filename}"', [
39 |                 'mode' => $filename ? 'attachment' : 'inline',
40 |                 'filename' => $filename ?? 'to_yaml.yaml',
41 |             ])
42 |         ]);
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/API/System/Users.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Enums\Http\Status;
 9 | use App\Libs\Mappers\ImportInterface as iImport;
10 | use App\Libs\Traits\APITraits;
11 | use Psr\Http\Message\ResponseInterface as iResponse;
12 | use Psr\Http\Message\ServerRequestInterface as iRequest;
13 | use Psr\Log\LoggerInterface as iLogger;
14 | 
15 | final class Users
16 | {
17 |     use APITraits;
18 | 
19 |     public const string URL = '%{api.prefix}/system/users';
20 | 
21 |     #[Get(self::URL . '[/]', name: 'system.users')]
22 |     public function __invoke(iRequest $request, iImport $mapper, iLogger $logger): iResponse
23 |     {
24 |         $users = [];
25 |         $usersContext = getUsersContext($mapper, $logger);
26 |         foreach ($usersContext as $username => $userContext) {
27 |             $users[] = [
28 |                 'user' => $username,
29 |                 'backends' => array_keys($userContext->config->getAll())
30 |             ];
31 |         }
32 | 
33 |         return api_response(Status::OK, ['users' => $users]);
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/API/System/Version.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\API\System;
 6 | 
 7 | use App\Libs\Attributes\Route\Get;
 8 | use App\Libs\Enums\Http\Status;
 9 | use Psr\Http\Message\ResponseInterface as iResponse;
10 | use Psr\Http\Message\ServerRequestInterface as iRequest;
11 | 
12 | final class Version
13 | {
14 |     public const string URL = '%{api.prefix}/system/version';
15 | 
16 |     #[Get(self::URL . '[/]', name: 'system.version')]
17 |     public function __invoke(iRequest $request): iResponse
18 |     {
19 |         return api_response(Status::OK, ['version' => getAppVersion(), 'container' => inContainer()]);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Backends/Common/GuidInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Common;
 6 | 
 7 | interface GuidInterface
 8 | {
 9 |     /**
10 |      * Set working context.
11 |      *
12 |      * @param Context $context Context to associate this object with.
13 |      *
14 |      * @return $this A new instance will be returned.
15 |      */
16 |     public function withContext(Context $context): self;
17 | 
18 |     /**
19 |      * Parse external ids from given list in safe way.
20 |      *
21 |      * @note this method is **NOT allowed** to log and throw exceptions.
22 |      *
23 |      * @param array $guids List of external ids to parse.
24 |      * @param array $context Context to associate this call with.
25 |      *
26 |      * @return array List of parsed external ids.
27 |      */
28 |     public function parse(array $guids, array $context = []): array;
29 | 
30 |     /**
31 |      * Parse supported external ids from given list.
32 |      *
33 |      * @note this method is allowed to log and throw exceptions.
34 |      *
35 |      * @param array $guids List of external ids to parse.
36 |      * @param array $context Context to associate this call with.
37 |      *
38 |      * @return array List of parsed and supported external ids.
39 |      */
40 |     public function get(array $guids, array $context = []): array;
41 | 
42 |     /**
43 |      * Does the given list contain supported external ids?
44 |      *
45 |      * @param array $guids List of external ids to check.
46 |      * @param array $context Context to associate this call with.
47 |      *
48 |      * @return bool True if the list contain supported external ids.
49 |      */
50 |     public function has(array $guids, array $context = []): bool;
51 | 
52 |     /**
53 |      * Is the given identifier a local id?
54 |      *
55 |      * @param string $guid External id to check.
56 |      *
57 |      * @return bool True if the given id is a local id.
58 |      */
59 |     public function isLocal(string $guid): bool;
60 | }
61 | 


--------------------------------------------------------------------------------
/src/Backends/Common/Levels.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Common;
 6 | 
 7 | enum Levels: string
 8 | {
 9 |     /**
10 |      * Detailed debug information
11 |      */
12 |     case DEBUG = 'DEBUG';
13 | 
14 |     /**
15 |      * Interesting events
16 |      *
17 |      * Examples: User logs in, SQL logs.
18 |      */
19 |     case INFO = 'INFO';
20 | 
21 |     /**
22 |      * Uncommon events
23 |      */
24 |     case NOTICE = 'NOTICE';
25 | 
26 |     /**
27 |      * Exceptional occurrences that are not errors
28 |      *
29 |      * Examples: Use of deprecated APIs, poor use of an API,
30 |      * undesirable things that are not necessarily wrong.
31 |      */
32 |     case WARNING = 'WARNING';
33 | 
34 |     /**
35 |      * Runtime errors
36 |      */
37 |     case ERROR = 'ERROR';
38 | 
39 |     /**
40 |      * Critical conditions
41 |      *
42 |      * Example: Application component unavailable, unexpected exception.
43 |      */
44 |     case CRITICAL = 'CRITICAL';
45 | 
46 |     /**
47 |      * Action must be taken immediately
48 |      *
49 |      * Example: Entire website down, database unavailable, etc.
50 |      * This should trigger the SMS alerts and wake you up.
51 |      */
52 |     case ALERT = 'ALERT';
53 | 
54 |     /**
55 |      * Urgent alert.
56 |      */
57 |     case EMERGENCY = 'EMERGENCY';
58 | 
59 | }
60 | 


--------------------------------------------------------------------------------
/src/Backends/Common/ManageInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Common;
 6 | 
 7 | interface ManageInterface
 8 | {
 9 |     /**
10 |      * Add or edit backend.
11 |      *
12 |      * @param array $backend Backend data.
13 |      * @param array $opts options.
14 |      *
15 |      * @return array return modified $backend data.
16 |      */
17 |     public function manage(array $backend, array $opts = []): array;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Backends/Common/Request.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Common;
 6 | 
 7 | use App\Libs\Enums\Http\Method;
 8 | use App\Libs\Uri;
 9 | use Closure;
10 | 
11 | final readonly class Request
12 | {
13 |     public string $id;
14 | 
15 |     /**
16 |      * Wrap client requests into object.
17 |      *
18 |      * @param Method $method The HTTP method to use.
19 |      * @param Uri|string $url The URL to send the request to.
20 |      * @param array $options The options to pass to the request.
21 |      * @param Closure|null $success The callback to call on successful response.
22 |      * @param Closure|null $error The callback to call on error response.
23 |      * @param array $extras An array that can contain anything. Should be rarely used.
24 |      */
25 |     public function __construct(
26 |         public Method $method,
27 |         public Uri|string $url,
28 |         public array $options = [],
29 |         public Closure|null $success = null,
30 |         public Closure|null $error = null,
31 |         public array $extras = [],
32 |     ) {
33 |         $this->id = generateUUID();
34 |     }
35 | 
36 |     public function toRequest(): array
37 |     {
38 |         return [
39 |             'method' => $this->method->value,
40 |             'url' => (string)$this->url,
41 |             'options' => $this->options,
42 |         ];
43 |     }
44 | 
45 |     public function __debugInfo()
46 |     {
47 |         return [
48 |             'id' => $this->id,
49 |             'method' => $this->method,
50 |             'url' => $this->url,
51 |             'options' => $this->options,
52 |             'success' => $this->success,
53 |             'error' => $this->error,
54 |         ];
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/src/Backends/Common/Response.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Common;
 6 | 
 7 | final readonly class Response
 8 | {
 9 |     /**
10 |      * Wrap clients responses into easy to consume object.
11 |      *
12 |      * @param bool $status Whether the operation is successful.
13 |      * @param mixed $response The actual response.
14 |      * @param Error|null $error If the response has an error.
15 |      * @param mixed $extra An array that can contain anything. Should be rarely used.
16 |      */
17 |     public function __construct(
18 |         public bool $status,
19 |         public mixed $response = null,
20 |         public Error|null $error = null,
21 |         public array $extra = [],
22 |     ) {
23 |     }
24 | 
25 |     /**
26 |      * Does the response contain an error object?
27 |      *
28 |      * @return bool True if the response has an error.
29 |      */
30 |     public function hasError(): bool
31 |     {
32 |         return null !== $this->error;
33 |     }
34 | 
35 |     /**
36 |      * Return error response.
37 |      *
38 |      * @return Error the error object if exists otherwise dummy error object is returned.
39 |      */
40 |     public function getError(): Error
41 |     {
42 |         return $this->error ?? new Error('No error logged.');
43 |     }
44 | 
45 |     /**
46 |      * Is the operation successful?
47 |      *
48 |      * @return bool true if the operation is successful.
49 |      */
50 |     public function isSuccessful(): bool
51 |     {
52 |         return $this->status;
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/Backup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class Backup extends \App\Backends\Jellyfin\Action\Backup
 8 | {
 9 |     protected string $action = 'emby.backup';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/Export.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class Export extends \App\Backends\Jellyfin\Action\Export
 8 | {
 9 |     protected string $action = 'emby.export';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GenerateAccessToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | final class GenerateAccessToken extends \App\Backends\Jellyfin\Action\GenerateAccessToken
 8 | {
 9 |     protected string $action = 'emby.generateAccessToken';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetIdentifier.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class GetIdentifier extends \App\Backends\Jellyfin\Action\GetIdentifier
 8 | {
 9 |     protected string $action = 'emby.getIdentifier';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetInfo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class GetInfo extends \App\Backends\Jellyfin\Action\GetInfo
 8 | {
 9 |     protected string $action = 'emby.getInfo';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetLibrariesList.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class GetLibrariesList extends \App\Backends\Jellyfin\Action\GetLibrariesList
 8 | {
 9 |     protected string $action = 'emby.getLibrariesList';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetLibrary.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class GetLibrary extends \App\Backends\Jellyfin\Action\GetLibrary
 8 | {
 9 |     protected string $action = 'emby.getLibrary';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetMetaData.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class GetMetaData extends \App\Backends\Jellyfin\Action\GetMetaData
 8 | {
 9 |     protected string $action = 'emby.getMetadata';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetSessions.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class GetSessions extends \App\Backends\Jellyfin\Action\GetSessions
 8 | {
 9 |     protected string $action = 'emby.getSessions';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetUser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | final class GetUser extends \App\Backends\Jellyfin\Action\GetUsersList
 8 | {
 9 |     protected string $action = 'emby.getUser';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetUsersList.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | final class GetUsersList extends \App\Backends\Jellyfin\Action\GetUsersList
 8 | {
 9 |     protected string $action = 'emby.getUsersList';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetVersion.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class GetVersion extends \App\Backends\Jellyfin\Action\GetVersion
 8 | {
 9 |     protected string $action = 'emby.getVersion';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/GetWebUrl.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class GetWebUrl extends \App\Backends\Jellyfin\Action\GetWebUrl
 8 | {
 9 |     protected string $action = 'emby.getWebUrl';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/Import.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class Import extends \App\Backends\Jellyfin\Action\Import
 8 | {
 9 |     protected string $action = 'emby.import';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/Proxy.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class Proxy extends \App\Backends\Jellyfin\Action\Proxy
 8 | {
 9 |     protected string $action = 'emby.proxy';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/Push.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class Push extends \App\Backends\Jellyfin\Action\Push
 8 | {
 9 |     protected string $action = 'emby.push';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/SearchId.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | final class SearchId extends \App\Backends\Jellyfin\Action\SearchId
 8 | {
 9 |     protected string $action = 'emby.searchId';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/SearchQuery.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class SearchQuery extends \App\Backends\Jellyfin\Action\SearchQuery
 8 | {
 9 |     protected string $action = 'emby.searchQuery';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/ToEntity.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | final class ToEntity extends \App\Backends\Jellyfin\Action\ToEntity
 8 | {
 9 |     protected string $action = 'emby.toEntity';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/UpdateState.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | class UpdateState extends \App\Backends\Jellyfin\Action\UpdateState
 8 | {
 9 |     protected string $action = 'emby.UpdateState';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/Action/getImagesUrl.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | 
11 | class getImagesUrl
12 | {
13 |     use CommonTrait;
14 | 
15 |     protected string $action = 'emby.getImagesUrl';
16 | 
17 |     /**
18 |      * Get Backend images url.
19 |      *
20 |      * @param Context $context backend context.
21 |      * @param string|int $id item id.
22 |      * @param array $opts optional options.
23 |      *
24 |      * @return Response
25 |      */
26 |     public function __invoke(Context $context, string|int $id, array $opts = []): Response
27 |     {
28 |         return $this->tryResponse(
29 |             context: $context,
30 |             fn: fn() => new Response(
31 |                 status: true,
32 |                 response: [
33 |                     'poster' => $context->backendUrl->withPath("/emby/Items/{$id}/Images/Primary/"),
34 |                     'background' => $context->backendUrl->withPath("/emby/Items/{$id}/Images/Backdrop/"),
35 |                 ]
36 |             ),
37 |             action: $this->action
38 |         );
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/EmbyActionTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby;
 6 | 
 7 | use App\Backends\Common\Context;
 8 | use App\Backends\Emby\Action\GetMetaData;
 9 | use App\Backends\Jellyfin\JellyfinActionTrait;
10 | use App\Libs\Container;
11 | use App\Libs\Exceptions\Backends\RuntimeException;
12 | 
13 | trait EmbyActionTrait
14 | {
15 |     use JellyfinActionTrait;
16 | 
17 |     /**
18 |      * Get item details.
19 |      *
20 |      * @param Context $context
21 |      * @param string|int $id
22 |      * @param array $opts
23 |      *
24 |      * @return array
25 |      * @throws RuntimeException When API call was not successful.
26 |      */
27 |     protected function getItemDetails(Context $context, string|int $id, array $opts = []): array
28 |     {
29 |         $response = Container::get(GetMetaData::class)(context: $context, id: $id, opts: $opts);
30 | 
31 |         if ($response->isSuccessful()) {
32 |             return $response->response;
33 |         }
34 | 
35 |         throw new RuntimeException(message: $response->error->format(), previous: $response->error->previous);
36 |     }
37 | 
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/EmbyGuid.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby;
 6 | 
 7 | final class EmbyGuid extends \App\Backends\Jellyfin\JellyfinGuid
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/EmbyManage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby;
 6 | 
 7 | use App\Backends\Jellyfin\JellyfinManage;
 8 | 
 9 | class EmbyManage extends JellyfinManage
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Backends/Emby/EmbyValidateContext.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Emby;
 6 | 
 7 | use App\Backends\Jellyfin\JellyfinValidateContext;
 8 | 
 9 | class EmbyValidateContext extends JellyfinValidateContext
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Backends/Jellyfin/Action/GetIdentifier.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Jellyfin\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | use Psr\Log\LoggerInterface as iLogger;
11 | use Symfony\Contracts\HttpClient\HttpClientInterface as iHttp;
12 | 
13 | /**
14 |  * Class GetIdentifier
15 |  *
16 |  * This class is responsible for retrieving the jellyfin instance unique identifier.
17 |  */
18 | class GetIdentifier
19 | {
20 |     use CommonTrait;
21 | 
22 |     /**
23 |      * @var string Action name
24 |      */
25 |     protected string $action = 'jellyfin.getIdentifier';
26 | 
27 |     /**
28 |      * Class constructor.
29 |      *
30 |      * @param iHttp $http The HTTP client instance to use.
31 |      * @param iLogger $logger The logger instance to use.
32 |      * @return void
33 |      */
34 |     public function __construct(protected readonly iHttp $http, protected readonly iLogger $logger)
35 |     {
36 |     }
37 | 
38 |     /**
39 |      * Get backend unique identifier.
40 |      *
41 |      * @param Context $context Backend context.
42 |      * @param array $opts (Optional) options.
43 |      *
44 |      * @return Response
45 |      */
46 |     public function __invoke(Context $context, array $opts = []): Response
47 |     {
48 |         return $this->tryResponse(
49 |             context: $context,
50 |             fn: function () use ($context, $opts) {
51 |                 $info = new GetInfo($this->http, $this->logger)(context: $context, opts: $opts);
52 | 
53 |                 if (false === $info->status) {
54 |                     return $info;
55 |                 }
56 | 
57 |                 return new Response(status: true, response: ag($info->response, 'identifier'));
58 |             },
59 |             action: $this->action,
60 |         );
61 |     }
62 | }
63 | 


--------------------------------------------------------------------------------
/src/Backends/Jellyfin/Action/GetVersion.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Jellyfin\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | use Psr\Log\LoggerInterface as iLogger;
11 | use Symfony\Contracts\HttpClient\HttpClientInterface as iHttp;
12 | 
13 | /**
14 |  * Class GetVersion
15 |  *
16 |  * Represents a class that retrieves the version of jellyfin server.
17 |  */
18 | class GetVersion
19 | {
20 |     use CommonTrait;
21 | 
22 |     /**
23 |      * @var string Action name.
24 |      */
25 |     protected string $action = 'jellyfin.getVersion';
26 | 
27 |     /**
28 |      * Class Constructor.
29 |      *
30 |      * @param iHttp $http The HTTP client instance.
31 |      * @param iLogger $logger The logger instance.
32 |      */
33 |     public function __construct(protected readonly iHttp $http, protected readonly iLogger $logger)
34 |     {
35 |     }
36 | 
37 |     /**
38 |      * Get Jellyfin server version.
39 |      *
40 |      * @param Context $context The context instance.
41 |      * @param array $opts The options array.
42 |      *
43 |      * @return Response The response.
44 |      */
45 |     public function __invoke(Context $context, array $opts = []): Response
46 |     {
47 |         return $this->tryResponse(
48 |             context: $context,
49 |             fn: function () use ($context, $opts) {
50 |                 $info = new GetInfo($this->http, $this->logger)(context: $context, opts: $opts);
51 | 
52 |                 if (false === $info->status) {
53 |                     return $info;
54 |                 }
55 | 
56 |                 return new Response(status: true, response: ag($info->response, 'version'));
57 |             },
58 |             action: $this->action,
59 |         );
60 |     }
61 | }
62 | 


--------------------------------------------------------------------------------
/src/Backends/Jellyfin/Action/ToEntity.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Jellyfin\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | use App\Backends\Jellyfin\JellyfinActionTrait;
11 | use App\Backends\Jellyfin\JellyfinGuid;
12 | use App\Libs\Entity\StateInterface;
13 | 
14 | class ToEntity
15 | {
16 |     use CommonTrait;
17 |     use JellyfinActionTrait;
18 | 
19 |     private string $action = 'jellyfin.toEntity';
20 | 
21 |     public function __construct(private JellyfinGuid $guid)
22 |     {
23 |     }
24 | 
25 |     /**
26 |      * Create an entity from the given item.
27 |      *
28 |      * @param Context $context
29 |      * @param array $item
30 |      * @param array $opts optional options.
31 |      *
32 |      * @return Response<StateInterface>
33 |      */
34 |     public function __invoke(Context $context, array $item, array $opts = []): Response
35 |     {
36 |         return $this->tryResponse(
37 |             context: $context,
38 |             fn: fn() => $this->createEntity($context, $this->guid->withContext($context), $item, $opts),
39 |             action: $this->action
40 |         );
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Backends/Jellyfin/Action/getImagesUrl.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Jellyfin\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | 
11 | class getImagesUrl
12 | {
13 |     use CommonTrait;
14 | 
15 |     protected string $action = 'jellyfin.getImagesUrl';
16 | 
17 |     /**
18 |      * Get Backend images url.
19 |      *
20 |      * @param Context $context backend context.
21 |      * @param string|int $id item id.
22 |      * @param array $opts optional options.
23 |      *
24 |      * @return Response
25 |      */
26 |     public function __invoke(Context $context, string|int $id, array $opts = []): Response
27 |     {
28 |         return $this->tryResponse(
29 |             context: $context,
30 |             fn: fn() => new Response(
31 |                 status: true,
32 |                 response: [
33 |                     'poster' => $context->backendUrl->withPath("/Items/{$id}/Images/Primary/"),
34 |                     'background' => $context->backendUrl->withPath("/Items/{$id}/Images/Backdrop/"),
35 |                 ]
36 |             ),
37 |             action: $this->action
38 |         );
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Backends/Plex/Action/GetIdentifier.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Plex\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | use Psr\Log\LoggerInterface as iLogger;
11 | use Symfony\Contracts\HttpClient\HttpClientInterface as iHttp;
12 | 
13 | final class GetIdentifier
14 | {
15 |     use CommonTrait;
16 | 
17 |     protected string $action = 'plex.getIdentifier';
18 | 
19 |     public function __construct(protected readonly iHttp $http, protected readonly iLogger $logger)
20 |     {
21 |     }
22 | 
23 |     /**
24 |      * Get Backend unique identifier.
25 |      *
26 |      * @param Context $context
27 |      * @param array $opts optional options.
28 |      *
29 |      * @return Response
30 |      */
31 |     public function __invoke(Context $context, array $opts = []): Response
32 |     {
33 |         return $this->tryResponse(
34 |             context: $context,
35 |             fn: function () use ($context, $opts) {
36 |                 $info = new GetInfo($this->http, $this->logger)(context: $context, opts: $opts);
37 | 
38 |                 if (false === $info->status) {
39 |                     return $info;
40 |                 }
41 | 
42 |                 return new Response(status: true, response: ag($info->response, 'identifier'));
43 |             },
44 |             action: $this->action
45 |         );
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Backends/Plex/Action/GetUser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Plex\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | use App\Libs\Container;
11 | use App\Libs\Exceptions\Backends\InvalidArgumentException;
12 | use App\Libs\Extends\RetryableHttpClient;
13 | use Psr\Log\LoggerInterface as iLogger;
14 | use Symfony\Contracts\HttpClient\HttpClientInterface as iHttp;
15 | 
16 | final class GetUser
17 | {
18 |     use CommonTrait;
19 | 
20 |     private int $maxRetry = 3;
21 |     private string $action = 'plex.getUser';
22 |     private iHttp $http;
23 | 
24 |     public function __construct(iHttp $http, protected iLogger $logger)
25 |     {
26 |         $this->http = new RetryableHttpClient(client: $http, maxRetries: $this->maxRetry, logger: $this->logger);
27 |     }
28 | 
29 |     /**
30 |      * Get Users list.
31 |      *
32 |      * @param Context $context
33 |      * @param array $opts optional options.
34 |      *
35 |      * @return Response
36 |      */
37 |     public function __invoke(Context $context, array $opts = []): Response
38 |     {
39 |         return $this->tryResponse(
40 |             context: $context,
41 |             fn: fn() => $this->getUser($context, $opts),
42 |             action: $this->action
43 |         );
44 |     }
45 | 
46 |     /**
47 |      * Get User list.
48 |      *
49 |      * @throws InvalidArgumentException if user id is not found.
50 |      */
51 |     private function getUser(Context $context, array $opts = []): Response
52 |     {
53 |         $users = Container::get(GetUsersList::class)($context, $opts);
54 | 
55 |         if ($users->hasError()) {
56 |             return $users;
57 |         }
58 | 
59 |         foreach ($users->response as $user) {
60 |             if ((int)$user['id'] === (int)$context->backendUser) {
61 |                 return new Response(status: true, response: $user);
62 |             }
63 |         }
64 | 
65 |         throw new InvalidArgumentException(r("Did not find matching user id '{id}' in users list.", [
66 |             'id' => $context->backendUser,
67 |         ]));
68 |     }
69 | }
70 | 


--------------------------------------------------------------------------------
/src/Backends/Plex/Action/GetVersion.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Plex\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | use Psr\Log\LoggerInterface as iLogger;
11 | use Symfony\Contracts\HttpClient\HttpClientInterface as iHttp;
12 | 
13 | final class GetVersion
14 | {
15 |     use CommonTrait;
16 | 
17 |     private string $action = 'plex.getVersion';
18 | 
19 |     public function __construct(protected readonly iHttp $http, protected readonly iLogger $logger)
20 |     {
21 |     }
22 | 
23 |     /**
24 |      * Get Backend unique identifier.
25 |      *
26 |      * @param Context $context
27 |      * @param array $opts optional options.
28 |      *
29 |      * @return Response
30 |      */
31 |     public function __invoke(Context $context, array $opts = []): Response
32 |     {
33 |         return $this->tryResponse(
34 |             context: $context,
35 |             fn: function () use ($context, $opts) {
36 |                 $info = new GetInfo($this->http, $this->logger)(context: $context, opts: $opts);
37 | 
38 |                 if (false === $info->status) {
39 |                     return $info;
40 |                 }
41 | 
42 |                 return new Response(status: true, response: ag($info->response, 'version'));
43 |             },
44 |             action: $this->action
45 |         );
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Backends/Plex/Action/ToEntity.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Plex\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | use App\Backends\Plex\PlexActionTrait;
11 | use App\Backends\Plex\PlexGuid;
12 | use App\Libs\Entity\StateEntity;
13 | 
14 | final class ToEntity
15 | {
16 |     use CommonTrait;
17 |     use PlexActionTrait;
18 | 
19 |     private string $action = 'plex.toEntity';
20 | 
21 |     public function __construct(private PlexGuid $guid)
22 |     {
23 |     }
24 | 
25 |     /**
26 |      * Create an entity from the given item.
27 |      *
28 |      * @param Context $context
29 |      * @param array $item
30 |      * @param array $opts optional options.
31 |      *
32 |      * @return Response<StateEntity>
33 |      */
34 |     public function __invoke(Context $context, array $item, array $opts = []): Response
35 |     {
36 |         return $this->tryResponse(
37 |             context: $context,
38 |             fn: fn() => $this->createEntity($context, $this->guid->withContext($context), $item, $opts),
39 |             action: $this->action
40 |         );
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Backends/Plex/Action/getImagesUrl.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Backends\Plex\Action;
 6 | 
 7 | use App\Backends\Common\CommonTrait;
 8 | use App\Backends\Common\Context;
 9 | use App\Backends\Common\Response;
10 | use App\Backends\Plex\PlexActionTrait;
11 | use App\Libs\Options;
12 | use DateInterval;
13 | 
14 | class getImagesUrl
15 | {
16 |     use CommonTrait;
17 |     use PlexActionTrait;
18 | 
19 |     protected string $action = 'jellyfin.getImagesUrl';
20 | 
21 |     /**
22 |      * Get Backend images url.
23 |      *
24 |      * @param Context $context backend context.
25 |      * @param string|int $id item id.
26 |      * @param array $opts optional options.
27 |      *
28 |      * @return Response
29 |      */
30 |     public function __invoke(Context $context, string|int $id, array $opts = []): Response
31 |     {
32 |         // -- Plex love's to play hard to get, so special care needed and API request is needed to fetch
33 |         // -- the images url.
34 |         $response = $this->getItemInfo($context, $id, opts: [Options::CACHE_TTL => new DateInterval('PT60M')]);
35 |         if (false === $response->isSuccessful()) {
36 |             return $response;
37 |         }
38 |         $data = ag($response->response, 'MediaContainer.Metadata.0', []);
39 | 
40 |         $poster = ag($data, 'thumb', null);
41 |         $background = ag($data, 'art', null);
42 | 
43 |         return $this->tryResponse(
44 |             context: $context,
45 |             fn: fn() => new Response(
46 |                 status: true,
47 |                 response: [
48 |                     'poster' => $poster ? $context->backendUrl->withPath($poster) : null,
49 |                     'background' => $background ? $context->backendUrl->withPath($background) : null,
50 |                 ]
51 |             ),
52 |             action: $this->action
53 |         );
54 |     }
55 | }
56 | 


--------------------------------------------------------------------------------
/src/Commands/Backend/VersionCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Commands\Backend;
 6 | 
 7 | use App\Command;
 8 | use App\Libs\Attributes\Route\Cli;
 9 | use RuntimeException;
10 | use Symfony\Component\Console\Input\InputInterface;
11 | use Symfony\Component\Console\Input\InputOption;
12 | use Symfony\Component\Console\Output\OutputInterface;
13 | 
14 | /**
15 |  * Class VersionCommand
16 |  *
17 |  * The VersionCommand class is used to retrieve the backend product version.
18 |  */
19 | #[Cli(command: self::ROUTE)]
20 | class VersionCommand extends Command
21 | {
22 |     public const string ROUTE = 'backend:version';
23 | 
24 |     /**
25 |      * Configures the command.
26 |      */
27 |     protected function configure(): void
28 |     {
29 |         $this->setName(self::ROUTE)
30 |             ->setDescription('Get backend product version.')
31 |             ->addOption('select-backend', 's', InputOption::VALUE_REQUIRED, 'Select backend.');
32 |     }
33 | 
34 |     /**
35 |      * Runs the command.
36 |      *
37 |      * @param InputInterface $input The input interface.
38 |      * @param OutputInterface $output The output interface.
39 |      *
40 |      * @return int The exit code of the command.
41 |      */
42 |     protected function runCommand(InputInterface $input, OutputInterface $output): int
43 |     {
44 |         $name = $input->getOption('select-backend');
45 |         if (empty($name)) {
46 |             $output->writeln(r('<error>ERROR: Backend not specified. Please use [-s, --select-backend].</error>'));
47 |             return self::FAILURE;
48 |         }
49 | 
50 |         try {
51 |             $backend = $this->getBackend($name);
52 |         } catch (RuntimeException) {
53 |             $output->writeln(r("<error>ERROR: Backend '{backend}' not found.</error>", ['backend' => $name]));
54 |             return self::FAILURE;
55 |         }
56 | 
57 |         $output->writeln($backend->getVersion());
58 | 
59 |         return self::SUCCESS;
60 |     }
61 | }
62 | 


--------------------------------------------------------------------------------
/src/Commands/Events/CacheCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Commands\Events;
 6 | 
 7 | use App\Command;
 8 | use App\Libs\Attributes\Route\Cli;
 9 | use Symfony\Component\Console\Input\InputInterface;
10 | use Symfony\Component\Console\Output\OutputInterface;
11 | 
12 | #[Cli(command: self::ROUTE)]
13 | final class CacheCommand extends Command
14 | {
15 |     public const string ROUTE = 'events:cache';
16 | 
17 |     protected function configure(): void
18 |     {
19 |         $this->setName(self::ROUTE)
20 |             ->setDescription('Force cache invalidation for the events registrar.');
21 |     }
22 | 
23 |     protected function execute(InputInterface $input, OutputInterface $output): int
24 |     {
25 |         registerEvents(ignoreCache: true);
26 | 
27 |         return self::SUCCESS;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Commands/Events/ListenersCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Commands\Events;
 6 | 
 7 | use App\Command;
 8 | use App\Libs\Attributes\Route\Cli;
 9 | use Psr\EventDispatcher\EventDispatcherInterface as iDispatcher;
10 | use Symfony\Component\Console\Input\InputInterface;
11 | use Symfony\Component\Console\Output\OutputInterface;
12 | use Symfony\Component\EventDispatcher\EventDispatcher;
13 | 
14 | #[Cli(command: self::ROUTE)]
15 | final class ListenersCommand extends Command
16 | {
17 |     public const string ROUTE = 'events:listeners';
18 | 
19 |     public function __construct(private readonly iDispatcher $dispatcher)
20 |     {
21 |         parent::__construct(null);
22 |     }
23 | 
24 |     protected function configure(): void
25 |     {
26 |         $this->setName(self::ROUTE)->setDescription('Show registered events Listeners.');
27 |     }
28 | 
29 |     protected function execute(InputInterface $input, OutputInterface $output): int
30 |     {
31 |         $mode = $input->getOption('output');
32 |         $keys = [];
33 | 
34 |         assert($this->dispatcher instanceof EventDispatcher);
35 |         foreach ($this->dispatcher->getListeners() as $key => $val) {
36 |             $listeners = [];
37 | 
38 |             foreach ($val as $listener) {
39 |                 $listeners[] = get_debug_type($listener);
40 |             }
41 | 
42 |             $keys[$key] = join(', ', $listeners);
43 |         }
44 | 
45 |         if ('table' === $mode) {
46 |             $list = [];
47 | 
48 |             foreach ($keys as $key => $val) {
49 |                 $list[] = ['Event' => $key, 'value' => $val];
50 |             }
51 | 
52 |             $keys = $list;
53 |         }
54 | 
55 |         $this->displayContent($keys, $output, $mode);
56 | 
57 |         return self::SUCCESS;
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/src/Commands/Events/QueuedCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Commands\Events;
 6 | 
 7 | use App\Command;
 8 | use App\Libs\Attributes\Route\Cli;
 9 | use App\Model\Events\EventsRepository;
10 | use App\Model\Events\EventsTable;
11 | use App\Model\Events\EventStatus as Status;
12 | use Symfony\Component\Console\Input\InputInterface;
13 | use Symfony\Component\Console\Input\InputOption;
14 | use Symfony\Component\Console\Output\OutputInterface;
15 | 
16 | #[Cli(command: self::ROUTE)]
17 | final class QueuedCommand extends Command
18 | {
19 |     public const string ROUTE = 'events:queued';
20 | 
21 |     public function __construct(private readonly EventsRepository $repo)
22 |     {
23 |         parent::__construct(null);
24 |     }
25 | 
26 |     protected function configure(): void
27 |     {
28 |         $this->setName(self::ROUTE)
29 |             ->addOption('all', 'a', InputOption::VALUE_NONE, 'Show all.')
30 |             ->setDescription('Show queued events.');
31 |     }
32 | 
33 |     protected function execute(InputInterface $input, OutputInterface $output): int
34 |     {
35 |         $filter = [
36 |             EventsTable::COLUMN_STATUS => Status::PENDING->value
37 |         ];
38 | 
39 |         if ($input->getOption('all')) {
40 |             $filter = [];
41 |         }
42 | 
43 |         $events = $this->repo->findAll($filter);
44 | 
45 |         $mode = $input->getOption('output');
46 | 
47 |         if ('table' === $mode) {
48 |             $list = [];
49 | 
50 |             foreach ($events as $event) {
51 |                 $list[] = [
52 |                     'id' => $event->id,
53 |                     'event' => $event->event,
54 |                     'added' => $event->created_at,
55 |                     'status' => ucfirst(strtolower($event->status->name)),
56 |                     'Dispatched' => $event->updated_at ?? 'N/A',
57 |                 ];
58 |             }
59 | 
60 |             $keys = $list;
61 |         } else {
62 |             $keys = array_map(fn($event) => $event->getAll(), $events);
63 |         }
64 | 
65 |         $this->displayContent($keys, $output, $mode);
66 | 
67 |         return self::SUCCESS;
68 |     }
69 | }
70 | 


--------------------------------------------------------------------------------
/src/Commands/System/APIKeyCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Commands\System;
 6 | 
 7 | use App\Command;
 8 | use App\Libs\Attributes\Route\Cli;
 9 | use App\Libs\Config;
10 | use App\Libs\Enums\Http\Status;
11 | use App\Libs\TokenUtil;
12 | use Symfony\Component\Console\Input\InputInterface as iInput;
13 | use Symfony\Component\Console\Input\InputOption;
14 | use Symfony\Component\Console\Output\OutputInterface as iOutput;
15 | 
16 | #[Cli(command: self::ROUTE)]
17 | final class APIKeyCommand extends Command
18 | {
19 |     public const string ROUTE = 'system:apikey';
20 | 
21 |     protected function configure(): void
22 |     {
23 |         $this->setName(self::ROUTE)
24 |             ->addOption('regenerate', 'r', InputOption::VALUE_NONE, 'Re-generate a new API key.')
25 |             ->setDescription('Show current API key or generate a new one.');
26 |     }
27 | 
28 |     protected function runCommand(iInput $input, iOutput $output): int
29 |     {
30 |         $regenerate = (bool)$input->getOption('regenerate');
31 |         if ($regenerate || null === ($apiKey = Config::get('api.key'))) {
32 |             return $this->regenerate($output);
33 |         }
34 | 
35 |         $output->writeln('<info>Current system API key:</info>');
36 |         $output->writeln('<comment>' . $apiKey . '</comment>');
37 | 
38 |         return self::SUCCESS;
39 |     }
40 | 
41 |     private function regenerate(iOutput $output): int
42 |     {
43 |         $apiKey = TokenUtil::generateSecret(16);
44 |         $response = APIRequest('POST', '/system/env/WS_API_KEY', [
45 |             'value' => $apiKey,
46 |         ]);
47 | 
48 |         if (Status::OK !== $response->status) {
49 |             $output->writeln(r("<error>Failed to set the new API key.</error>"));
50 |             return self::FAILURE;
51 |         }
52 | 
53 |         $output->writeln('<info>The New system API key:</info>');
54 |         $output->writeln('<comment>' . $apiKey . '</comment>');
55 | 
56 |         return self::SUCCESS;
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/src/Commands/System/ResetPasswordCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Commands\System;
 6 | 
 7 | use App\Command;
 8 | use App\Libs\Attributes\Route\Cli;
 9 | use App\Libs\Enums\Http\Status;
10 | use Symfony\Component\Console\Input\InputInterface as iInput;
11 | use Symfony\Component\Console\Output\OutputInterface as iOutput;
12 | 
13 | #[Cli(command: self::ROUTE)]
14 | final class ResetPasswordCommand extends Command
15 | {
16 |     public const string ROUTE = 'system:resetpassword';
17 | 
18 |     protected function configure(): void
19 |     {
20 |         $this->setName(self::ROUTE)
21 |             ->setDescription('Reset the system user and password.')
22 |             ->setHelp('Resets the current system user and password.');
23 |     }
24 | 
25 |     protected function runCommand(iInput $input, iOutput $output): int
26 |     {
27 |         $response = APIRequest('DELETE', '/system/env/WS_SYSTEM_SECRET');
28 |         if (Status::OK !== $response->status) {
29 |             $output->writeln(r("<error>Failed to reset the system secret key.</error>"));
30 |             return self::FAILURE;
31 |         }
32 | 
33 |         $response = APIRequest('DELETE', '/system/env/WS_SYSTEM_USER');
34 |         if (Status::OK !== $response->status) {
35 |             $output->writeln(r("<error>Failed to reset the system user.</error>"));
36 |             return self::FAILURE;
37 |         }
38 | 
39 |         $response = APIRequest('DELETE', '/system/env/WS_SYSTEM_PASSWORD');
40 |         if (Status::OK !== $response->status) {
41 |             $output->writeln(r("<error>Failed to reset the system password.</error>"));
42 |             return self::FAILURE;
43 |         }
44 | 
45 |         $output->writeln(r("<info>System user and password has been reset.</info>"));
46 | 
47 |         return self::SUCCESS;
48 |     }
49 | }
50 | 


--------------------------------------------------------------------------------
/src/Libs/APIResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs;
 6 | 
 7 | use App\Libs\Enums\Http\Status;
 8 | use Psr\Http\Message\StreamInterface as iStream;
 9 | 
10 | /**
11 |  * Class Config
12 |  *
13 |  * This class provides methods to manage configuration settings.
14 |  */
15 | final readonly class APIResponse
16 | {
17 |     public function __construct(
18 |         public Status $status,
19 |         public array $headers = [],
20 |         public array $body = [],
21 |         public iStream|null $stream = null
22 |     ) {
23 |     }
24 | 
25 |     /**
26 |      * Check if the response has a stream.
27 |      *
28 |      * @return bool True if the response has a stream, false otherwise.
29 |      */
30 |     public function hasStream(): bool
31 |     {
32 |         return null !== $this->stream;
33 |     }
34 | 
35 |     /**
36 |      * Check if the response has a body.
37 |      *
38 |      * @return bool True if the response has a body, false otherwise.
39 |      */
40 |     public function hasBody(): bool
41 |     {
42 |         return !empty($this->body);
43 |     }
44 | 
45 |     /**
46 |      * Check if the response has headers.
47 |      *
48 |      * @return bool  True if the response has headers, false otherwise.
49 |      */
50 |     public function hasHeaders(): bool
51 |     {
52 |         return !empty($this->headers);
53 |     }
54 | 
55 |     /**
56 |      * Get Header from the response headers.
57 |      *
58 |      * @param string $key The key to get from the headers.
59 |      * @param mixed|null $default The default value to return if the key is not found.
60 |      *
61 |      * @return mixed The value of the key from the headers. If the key is not found, the default value is returned.
62 |      */
63 |     public function getHeader(string $key, mixed $default = null): mixed
64 |     {
65 |         return ag($this->headers, $key, $default);
66 |     }
67 | 
68 |     /**
69 |      * Get Parameter from the parsed body content.
70 |      *
71 |      * @param string $key The key to get from the body.
72 |      * @param mixed|null $default The default value to return if the key is not found.
73 |      *
74 |      * @return mixed The value of the key from the body. If the key is not found, the default value is returned.
75 |      */
76 |     public function getParam(string $key, mixed $default = null): mixed
77 |     {
78 |         return ag($this->body, $key, $default);
79 |     }
80 | }
81 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/DI/Inject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\DI;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_PARAMETER)]
10 | readonly class Inject
11 | {
12 |     /**
13 |      * Dynamically override dependency resolve. This is useful when you want to
14 |      * resolve a dependency to a specific class which is not the same as the
15 |      * type-hinted interface.
16 |      *
17 |      * For example, you have an interface `LoggerInterface` and you have two
18 |      * classes that implement this interface: `FileLogger` and `DatabaseLogger`.
19 |      * And you want to resolve the `LoggerInterface` to `FileLogger` when it is
20 |      * type-hinted in a constructor. You can use this attribute to achieve that.
21 |      * By doing the following:
22 |      *
23 |      * <code>
24 |      * class Example
25 |      * {
26 |      *    public function __invoke(#[Inject(FileLogger::class)] private LoggerInterface $logger) {}
27 |      * }
28 |      * </code>
29 |      *
30 |      * @param string $name
31 |      */
32 |     public function __construct(public string $name)
33 |     {
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Cli.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS)]
10 | final class Cli extends Route
11 | {
12 |     public function __construct(string $command)
13 |     {
14 |         parent::__construct(methods: [], pattern: $command, opts: ['cli' => true]);
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Delete.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | final class Delete extends Route
11 | {
12 |     public function __construct(
13 |         string $pattern,
14 |         array|string $middleware = [],
15 |         string|null $host = null,
16 |         string|null $name = null,
17 |         string|null $scheme = null,
18 |         string|int|null $port = null,
19 |     ) {
20 |         parent::__construct(
21 |             methods: ['DELETE'],
22 |             pattern: $pattern,
23 |             middleware: $middleware,
24 |             host: $host,
25 |             name: $name,
26 |             scheme: $scheme,
27 |             port: $port
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Get.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | final class Get extends Route
11 | {
12 |     public function __construct(
13 |         string $pattern,
14 |         array|string $middleware = [],
15 |         string|null $host = null,
16 |         string|null $name = null,
17 |         string|null $scheme = null,
18 |         string|int|null $port = null,
19 |     ) {
20 |         parent::__construct(
21 |             methods: ['GET'],
22 |             pattern: $pattern,
23 |             middleware: $middleware,
24 |             host: $host,
25 |             name: $name,
26 |             scheme: $scheme,
27 |             port: $port
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Head.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | final class Head extends Route
11 | {
12 |     public function __construct(
13 |         string $pattern,
14 |         array|string $middleware = [],
15 |         string|null $host = null,
16 |         string|null $name = null,
17 |         string|null $scheme = null,
18 |         string|int|null $port = null,
19 |     ) {
20 |         parent::__construct(
21 |             methods: ['HEAD'],
22 |             pattern: $pattern,
23 |             middleware: $middleware,
24 |             host: $host,
25 |             name: $name,
26 |             scheme: $scheme,
27 |             port: $port
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Options.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | final class Options extends Route
11 | {
12 |     public function __construct(
13 |         string $pattern,
14 |         array|string $middleware = [],
15 |         string|null $host = null,
16 |         string|null $name = null,
17 |         string|null $scheme = null,
18 |         string|int|null $port = null,
19 |     ) {
20 |         parent::__construct(
21 |             methods: ['OPTIONS'],
22 |             pattern: $pattern,
23 |             middleware: $middleware,
24 |             host: $host,
25 |             name: $name,
26 |             scheme: $scheme,
27 |             port: $port
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Patch.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | final class Patch extends Route
11 | {
12 |     public function __construct(
13 |         string $pattern,
14 |         array|string $middleware = [],
15 |         string|null $host = null,
16 |         string|null $name = null,
17 |         string|null $scheme = null,
18 |         string|int|null $port = null,
19 |     ) {
20 |         parent::__construct(
21 |             methods: ['PATCH'],
22 |             pattern: $pattern,
23 |             middleware: $middleware,
24 |             host: $host,
25 |             name: $name,
26 |             scheme: $scheme,
27 |             port: $port
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Post.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | final class Post extends Route
11 | {
12 |     public function __construct(
13 |         string $pattern,
14 |         array|string $middleware = [],
15 |         string|null $host = null,
16 |         string|null $name = null,
17 |         string|null $scheme = null,
18 |         string|int|null $port = null,
19 |     ) {
20 |         parent::__construct(
21 |             methods: ['POST'],
22 |             pattern: $pattern,
23 |             middleware: $middleware,
24 |             host: $host,
25 |             name: $name,
26 |             scheme: $scheme,
27 |             port: $port
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Put.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | final class Put extends Route
11 | {
12 |     public function __construct(
13 |         string $pattern,
14 |         array|string $middleware = [],
15 |         string|null $host = null,
16 |         string|null $name = null,
17 |         string|null $scheme = null,
18 |         string|int|null $port = null,
19 |     ) {
20 |         parent::__construct(
21 |             methods: ['PUT'],
22 |             pattern: $pattern,
23 |             middleware: $middleware,
24 |             host: $host,
25 |             name: $name,
26 |             scheme: $scheme,
27 |             port: $port
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Route/Route.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Route;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | class Route
11 | {
12 |     public readonly bool $isCli;
13 |     public readonly array $methods;
14 |     public readonly string $pattern;
15 |     public readonly array $middleware;
16 |     public readonly string|null $host;
17 |     public readonly string|null $name;
18 |     public readonly string|null $scheme;
19 |     public readonly string|int|null $port;
20 | 
21 |     /**
22 |      * Generate Dynamic Route.
23 |      *
24 |      * @param array $methods HTTP Methods.
25 |      * @param string $pattern Path pattern.
26 |      * @param array|string $middleware List of middlewares.
27 |      * @param string|null $host Required host. Use %{config.name} for config value
28 |      * @param string|null $name Route name.
29 |      * @param string|null $scheme Request scheme. Use %{config.name} for config value
30 |      * @param string|int|null $port Request Port. Use %{config.name} for config value
31 |      */
32 |     public function __construct(
33 |         array $methods,
34 |         string $pattern,
35 |         array|string $middleware = [],
36 |         string|null $host = null,
37 |         string|null $name = null,
38 |         string|null $scheme = null,
39 |         string|int|null $port = null,
40 |         array $opts = []
41 |     ) {
42 |         $this->name = $name;
43 |         $this->methods = $methods;
44 |         $this->pattern = parseConfigValue($pattern);
45 |         $this->middleware = is_string($middleware) ? [$middleware] : $middleware;
46 |         $this->port = null !== $port ? parseConfigValue($port) : $port;
47 |         $this->scheme = null !== $scheme ? parseConfigValue($scheme) : $scheme;
48 |         $this->host = null !== $host ? parseConfigValue($host, fn($v) => parse_url($v, PHP_URL_HOST)) : $host;
49 | 
50 |         $this->isCli = true === (bool)ag($opts, 'cli', false);
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Scanner/Item.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Attributes\Scanner;
 6 | 
 7 | use App\Libs\Container;
 8 | use Closure;
 9 | 
10 | final readonly class Item
11 | {
12 |     public function __construct(
13 |         public Target $target,
14 |         public string $attribute,
15 |         public string|array|Closure $callable,
16 |         public array $data = []
17 |     ) {
18 |     }
19 | 
20 |     public function getCallable(): string|array|Closure
21 |     {
22 |         return $this->callable;
23 |     }
24 | 
25 |     public function call(...$args): mixed
26 |     {
27 |         $callable = $this->callable;
28 | 
29 |         if (is_string($callable) && str_contains($callable, '::')) {
30 |             $callable = explode('::', $callable);
31 |         }
32 | 
33 |         if (is_array($callable) && isset($callable[0]) && is_object($callable[0])) {
34 |             $callable = [$callable[0], $callable[1]];
35 |         }
36 | 
37 |         if (is_array($callable) && isset($callable[0]) && is_string($callable[0])) {
38 |             $callable = [$this->resolve($callable[0]), $callable[1]];
39 |         }
40 | 
41 |         if (is_string($callable)) {
42 |             $callable = $this->resolve($callable);
43 |         }
44 | 
45 |         return $callable(...$args);
46 |     }
47 | 
48 |     public function getTarget(): Target
49 |     {
50 |         return $this->target;
51 |     }
52 | 
53 |     public function getAttribute(): string
54 |     {
55 |         return $this->attribute;
56 |     }
57 | 
58 |     public function getData(): array
59 |     {
60 |         return $this->data;
61 |     }
62 | 
63 |     private function resolve(string $class)
64 |     {
65 |         if (Container::has($class)) {
66 |             return Container::get($class);
67 |         }
68 | 
69 |         if (class_exists($class)) {
70 |             return new $class();
71 |         }
72 | 
73 |         return $class;
74 |     }
75 | }
76 | 


--------------------------------------------------------------------------------
/src/Libs/Attributes/Scanner/Target.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Libs\Attributes\Scanner;
 4 | 
 5 | enum Target
 6 | {
 7 |     case IS_CLASS;
 8 |     case IS_METHOD;
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Libs/DataUtil.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs;
 6 | 
 7 | use Closure;
 8 | use JsonSerializable;
 9 | use Psr\Http\Message\ServerRequestInterface as iRequest;
10 | use Stringable;
11 | 
12 | final readonly class DataUtil implements JsonSerializable, Stringable
13 | {
14 |     private array $data;
15 | 
16 |     public function __construct(Closure|array $data)
17 |     {
18 |         $this->data = getValue($data);
19 |     }
20 | 
21 |     public static function fromArray(array $data): self
22 |     {
23 |         return new self($data);
24 |     }
25 | 
26 |     public static function fromRequest(iRequest $request, bool $includeQueryParams = false): self
27 |     {
28 |         $params = $includeQueryParams ? $request->getQueryParams() : [];
29 | 
30 |         if (null !== ($data = $request->getParsedBody())) {
31 |             $params = array_replace_recursive($params, is_object($data) ? (array)$data : $data);
32 |         }
33 | 
34 |         return new self($params);
35 |     }
36 | 
37 |     public function get(string $key, mixed $default = null): mixed
38 |     {
39 |         return ag($this->data, $key, $default);
40 |     }
41 | 
42 |     public function getAll(): array
43 |     {
44 |         return $this->data;
45 |     }
46 | 
47 |     public function has(string $key): bool
48 |     {
49 |         return ag_exists($this->data, $key);
50 |     }
51 | 
52 |     public function map(callable $callback): self
53 |     {
54 |         return new self(array_map($callback, $this->data));
55 |     }
56 | 
57 |     public function filter(callable $callback): self
58 |     {
59 |         return new self(array_filter($this->data, $callback, ARRAY_FILTER_USE_BOTH));
60 |     }
61 | 
62 |     public function with(string $key, mixed $value): self
63 |     {
64 |         return new self(ag_set($this->data, $key, $value));
65 |     }
66 | 
67 |     public function without(string $key): self
68 |     {
69 |         return new self(ag_delete($this->data, $key));
70 |     }
71 | 
72 |     public function jsonSerialize(): mixed
73 |     {
74 |         return $this->data;
75 |     }
76 | 
77 |     public function __toString(): string
78 |     {
79 |         return json_encode($this->jsonSerialize());
80 |     }
81 | }
82 | 


--------------------------------------------------------------------------------
/src/Libs/Enums/Http/Method.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Libs\Enums\Http;
 4 | 
 5 | /**
 6 |  * Http Methods
 7 |  */
 8 | enum Method: string
 9 | {
10 |     case GET = 'GET';
11 |     case POST = 'POST';
12 |     case PUT = 'PUT';
13 |     case DELETE = 'DELETE';
14 |     case PATCH = 'PATCH';
15 |     case OPTIONS = 'OPTIONS';
16 |     case HEAD = 'HEAD';
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Libs/Events/DataEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Libs\Events;
 4 | 
 5 | use App\Model\Events\Event as EventInfo;
 6 | use App\Model\Events\EventStatus;
 7 | use Symfony\Contracts\EventDispatcher\Event;
 8 | 
 9 | class DataEvent extends Event
10 | {
11 |     private EventStatus $status;
12 | 
13 |     public function __construct(private readonly EventInfo $eventInfo)
14 |     {
15 |         $this->status = $eventInfo->status;
16 |     }
17 | 
18 |     public function getStatus(): EventStatus
19 |     {
20 |         return $this->status;
21 |     }
22 | 
23 |     public function setStatus(EventStatus $status): DataEvent
24 |     {
25 |         $this->status = $status;
26 |         return $this;
27 |     }
28 | 
29 |     public function getEvent(): EventInfo
30 |     {
31 |         return $this->eventInfo;
32 |     }
33 | 
34 |     public function getReference(): string|null
35 |     {
36 |         return $this->eventInfo->reference;
37 |     }
38 | 
39 |     public function addLog(string $log): void
40 |     {
41 |         if (count($this->eventInfo->logs) >= 200) {
42 |             array_shift($this->eventInfo->logs);
43 |         }
44 |         $this->eventInfo->logs[] = $log;
45 |     }
46 | 
47 |     public function clearLogs(): void
48 |     {
49 |         $this->eventInfo->logs = [];
50 |     }
51 | 
52 |     public function getLogs(): array
53 |     {
54 |         return $this->eventInfo->logs;
55 |     }
56 | 
57 |     public function getData(): array
58 |     {
59 |         return $this->eventInfo->event_data;
60 |     }
61 | 
62 |     public function getOptions(): array
63 |     {
64 |         return $this->eventInfo->options;
65 |     }
66 | }
67 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/AppExceptionInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Libs\Exceptions;
 4 | 
 5 | interface AppExceptionInterface
 6 | {
 7 |     /**
 8 |      * Add extra context to the exception.
 9 |      *
10 |      * @param string $key The context key
11 |      * @param mixed $val The context value
12 |      *
13 |      * @return AppExceptionInterface
14 |      */
15 |     public function addContext(string $key, mixed $val): AppExceptionInterface;
16 | 
17 |     /**
18 |      * Replace the context with the provided array.
19 |      *
20 |      * @param array $context The context array.
21 |      *
22 |      * @return AppExceptionInterface
23 |      */
24 |     public function setContext(array $context): AppExceptionInterface;
25 | 
26 |     /**
27 |      * Get the context array or a specific key from the context.
28 |      *
29 |      * @param string|null $key The context key.
30 |      *
31 |      * @return mixed
32 |      */
33 |     public function getContext(string|null $key = null): mixed;
34 | 
35 |     /**
36 |      * Does the exception contain context?
37 |      *
38 |      * @return bool
39 |      */
40 |     public function hasContext(): bool;
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/Backends/BackendException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions\Backends;
 6 | 
 7 | use App\Libs\Exceptions\AppExceptionInterface;
 8 | use App\Libs\Exceptions\UseAppException;
 9 | use ErrorException;
10 | 
11 | /**
12 |  * Base Exception class for the backends errors.
13 |  */
14 | class BackendException extends ErrorException implements AppExceptionInterface
15 | {
16 |     use UseAppException;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/Backends/InvalidArgumentException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions\Backends;
 6 | 
 7 | /**
 8 |  * Class InvalidArgumentException
 9 |  */
10 | class InvalidArgumentException extends BackendException
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/Backends/InvalidContextException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions\Backends;
 6 | 
 7 | /**
 8 |  * Class InvalidContextException
 9 |  */
10 | class InvalidContextException extends BackendException
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/Backends/NotImplementedException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions\Backends;
 6 | 
 7 | /**
 8 |  * Class UnexpectedVersionException
 9 |  *
10 |  * This exception is thrown when the requested method is not implemented by the backend.
11 |  */
12 | class NotImplementedException extends BackendException
13 | {
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/Backends/RuntimeException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions\Backends;
 6 | 
 7 | /**
 8 |  * Class RuntimeException
 9 |  */
10 | class RuntimeException extends BackendException
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/Backends/UnexpectedVersionException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions\Backends;
 6 | 
 7 | /**
 8 |  * Class UnexpectedVersionException
 9 |  *
10 |  * This exception is thrown when backend version is unexpected.
11 |  */
12 | class UnexpectedVersionException extends BackendException
13 | {
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/DBAdapterException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /**
10 |  * Class DatabaseException
11 |  *
12 |  * The DatabaseException class extends the RuntimeException class and represents an exception
13 |  * that is thrown when there is an error related to the database operation.
14 |  */
15 | class DBAdapterException extends RuntimeException implements AppExceptionInterface
16 | {
17 |     use UseAppException;
18 | 
19 |     public string $queryString = '';
20 |     public array $bind = [];
21 | 
22 |     public array $options = [];
23 |     public array $errorInfo = [];
24 | 
25 |     /**
26 |      * @param string $queryString
27 |      * @param array $bind
28 |      * @param array $errorInfo
29 |      * @param string|int $errorCode
30 |      *
31 |      * @return $this
32 |      */
33 |     public function setInfo(
34 |         string $queryString,
35 |         array $bind = [],
36 |         array $errorInfo = [],
37 |         mixed $errorCode = 0
38 |     ): self {
39 |         $this->queryString = $queryString;
40 |         $this->bind = $bind;
41 |         $this->errorInfo = $errorInfo;
42 |         $this->code = $errorCode;
43 | 
44 |         return $this;
45 |     }
46 | 
47 |     public function getQueryString(): string
48 |     {
49 |         return $this->queryString;
50 |     }
51 | 
52 |     public function getQueryBind(): array
53 |     {
54 |         return $this->bind;
55 |     }
56 | 
57 |     public function setFile(string $file): DBAdapterException
58 |     {
59 |         $this->file = $file;
60 | 
61 |         return $this;
62 |     }
63 | 
64 |     public function setLine(int $line): DBAdapterException
65 |     {
66 |         $this->line = $line;
67 | 
68 |         return $this;
69 |     }
70 | 
71 |     public function setOptions(array $options): DBAdapterException
72 |     {
73 |         $this->options = $options;
74 | 
75 |         return $this;
76 |     }
77 | }
78 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/DBLayerException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions;
 6 | 
 7 | use PDOException;
 8 | 
 9 | /**
10 |  * Class DatabaseException
11 |  *
12 |  * The DatabaseException class extends the RuntimeException class and represents an exception
13 |  * that is thrown when there is an error related to the database operation.
14 |  */
15 | class DBLayerException extends PDOException implements AppExceptionInterface
16 | {
17 |     use UseAppException;
18 | 
19 |     public string $queryString = '';
20 |     public array $bind = [];
21 | 
22 |     public array $options = [];
23 |     public array|null $errorInfo = [];
24 | 
25 |     /**
26 |      * @param string $queryString
27 |      * @param array $bind
28 |      * @param array $errorInfo
29 |      * @param string|int $errorCode
30 |      *
31 |      * @return $this
32 |      */
33 |     public function setInfo(
34 |         string $queryString,
35 |         array $bind = [],
36 |         array $errorInfo = [],
37 |         mixed $errorCode = 0
38 |     ): self {
39 |         $this->queryString = $queryString;
40 |         $this->bind = $bind;
41 |         $this->errorInfo = $errorInfo;
42 |         $this->code = $errorCode;
43 | 
44 |         return $this;
45 |     }
46 | 
47 |     public function getQueryString(): string
48 |     {
49 |         return $this->queryString;
50 |     }
51 | 
52 |     public function getQueryBind(): array
53 |     {
54 |         return $this->bind;
55 |     }
56 | 
57 |     public function setFile(string $file): DBLayerException
58 |     {
59 |         $this->file = $file;
60 | 
61 |         return $this;
62 |     }
63 | 
64 |     public function setLine(int $line): DBLayerException
65 |     {
66 |         $this->line = $line;
67 | 
68 |         return $this;
69 |     }
70 | 
71 |     public function setOptions(array $options): DBLayerException
72 |     {
73 |         $this->options = $options;
74 | 
75 |         return $this;
76 |     }
77 | }
78 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/EmitterException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | class EmitterException extends RuntimeException implements AppExceptionInterface
10 | {
11 |     public const int HEADERS_SENT = 500;
12 |     public const int OUTPUT_SENT = 501;
13 | 
14 |     use UseAppException;
15 | 
16 |     public static function forHeadersSent(string $filename, int $line): self
17 |     {
18 |         return new self(r('Unable to emit response. Headers already sent in %s:%d', [
19 |             'filename' => $filename,
20 |             'line' => $line,
21 |         ]), code: self::HEADERS_SENT);
22 |     }
23 | 
24 |     public static function forOutputSent(): self
25 |     {
26 |         return new self('Output has been emitted previously. Cannot emit response.', code: self::OUTPUT_SENT);
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/ErrorException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions;
 6 | 
 7 | /**
 8 |  * Class ErrorException
 9 |  */
10 | class ErrorException extends \ErrorException implements AppExceptionInterface
11 | {
12 |     use UseAppException;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/HttpException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions;
 6 | 
 7 | class HttpException extends RuntimeException implements AppExceptionInterface
 8 | {
 9 |     use UseAppException;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/InvalidArgumentException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions;
 6 | 
 7 | /**
 8 |  * Class InvalidArgumentException
 9 |  */
10 | class InvalidArgumentException extends \InvalidArgumentException implements AppExceptionInterface
11 | {
12 |     use UseAppException;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/RuntimeException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions;
 6 | 
 7 | /**
 8 |  * General runtime exception.
 9 |  */
10 | class RuntimeException extends \RuntimeException implements AppExceptionInterface
11 | {
12 |     use UseAppException;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/UseAppException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Libs\Exceptions;
 4 | 
 5 | trait UseAppException
 6 | {
 7 |     protected array $appContext = [];
 8 | 
 9 |     public function addContext(string $key, mixed $value): AppExceptionInterface
10 |     {
11 |         $this->appContext = ag_set($this->appContext, $key, $value);
12 |         return $this;
13 |     }
14 | 
15 |     public function setContext(array $context): AppExceptionInterface
16 |     {
17 |         $this->appContext = $context;
18 | 
19 |         return $this;
20 |     }
21 | 
22 |     public function getContext(string|null $key = null): mixed
23 |     {
24 |         if (null === $key) {
25 |             return $this->appContext;
26 |         }
27 | 
28 |         return ag($this->appContext, $key);
29 |     }
30 | 
31 |     public function hasContext(): bool
32 |     {
33 |         return !empty($this->appContext);
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Libs/Exceptions/ValidationException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Exceptions;
 6 | 
 7 | /**
 8 |  * Class ValidationException
 9 |  */
10 | class ValidationException extends RuntimeException implements AppExceptionInterface
11 | {
12 |     use UseAppException;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Libs/Extends/Date.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Extends;
 6 | 
 7 | use App\Libs\Exceptions\InvalidArgumentException;
 8 | use DateTimeImmutable;
 9 | use DateTimeInterface;
10 | use DateTimeZone;
11 | use JsonSerializable;
12 | use Stringable;
13 | 
14 | final class Date extends DateTimeImmutable implements Stringable, JsonSerializable
15 | {
16 |     public const string ATOM = DateTimeInterface::ATOM;
17 | 
18 |     public function __construct(string|int $time = 'now', ?DateTimeZone $timezone = null)
19 |     {
20 |         $ori = $time;
21 | 
22 |         if (ctype_digit($time)) {
23 |             $time = '@' . $time;
24 |         }
25 | 
26 |         try {
27 |             parent::__construct($time, $timezone);
28 |         } catch (\TypeError $e) {
29 |             throw new InvalidArgumentException(
30 |                 r("DateTime constructor received invalid time argument \'{arg}\' - {ori}. {message}", [
31 |                     'arg' => $time,
32 |                     'ori' => $ori,
33 |                     'message' => $e->getMessage(),
34 |                 ]), $e->getCode(), $e
35 |             );
36 |         }
37 |     }
38 | 
39 |     public function __toString(): string
40 |     {
41 |         return $this->format(DateTimeInterface::ATOM);
42 |     }
43 | 
44 |     public function jsonSerialize(): string
45 |     {
46 |         return $this->__toString();
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Libs/Extends/LogMessageProcessor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Extends;
 6 | 
 7 | use Monolog\LogRecord;
 8 | use Monolog\Processor\ProcessorInterface;
 9 | 
10 | /**
11 |  * Class LogMessageProcessor
12 |  *
13 |  * This class implements the ProcessorInterface and is used to process log messages.
14 |  * It checks if the log message contains curly brackets "{", and if not, it returns the original log record.
15 |  * If the log message contains curly brackets "{", it replaces the placeholders with values from the context
16 |  * using the r_array function and returns the log record with the updated message.
17 |  */
18 | class LogMessageProcessor implements ProcessorInterface
19 | {
20 |     /**
21 |      * Invoke the method with a LogRecord object as parameter.
22 |      *
23 |      * @param LogRecord $record The LogRecord object to be processed.
24 |      *
25 |      * @return LogRecord Returns a modified LogRecord object. if th message contains curly brackets.
26 |      */
27 |     public function __invoke(LogRecord $record): LogRecord
28 |     {
29 |         if (false === str_contains($record->message, '{')) {
30 |             return $record;
31 |         }
32 | 
33 |         $repl = r_array(text: $record->message, context: $record->context, opts: [
34 |             'log_behavior' => true
35 |         ]);
36 | 
37 |         return $record->with(...$repl);
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Libs/Extends/MockHttpClient.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Extends;
 6 | 
 7 | use App\Libs\Enums\Http\Method;
 8 | use Symfony\Contracts\HttpClient\ResponseInterface as iResponse;
 9 | 
10 | /**
11 |  * RetryableHttpClient proxy. This Class acts as proxy in front of the Symfony RetryableHttpClient.
12 |  *
13 |  */
14 | class MockHttpClient extends \Symfony\Component\HttpClient\MockHttpClient
15 | {
16 |     public function request(string|Method $method, string $url, array $options = []): iResponse
17 |     {
18 |         if (true === ($method instanceof Method)) {
19 |             $method = $method->value;
20 |         }
21 | 
22 |         return parent::request($method, $url, $options);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Libs/Extends/PSRContainer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Extends;
 6 | 
 7 | use League\Container\Container;
 8 | 
 9 | final class PSRContainer extends Container
10 | {
11 |     /**
12 |      * Get Instance of a class.
13 |      *
14 |      * @template T
15 |      * @param class-string<T> $id
16 |      * @return T
17 |      */
18 |     public function get($id)
19 |     {
20 |         return parent::get($id);
21 |     }
22 | 
23 |     /**
24 |      * Get new instance of a class.
25 |      *
26 |      * @template T
27 |      * @param class-string<T> $id
28 |      * @return T
29 |      */
30 |     public function getNew($id)
31 |     {
32 |         return parent::getNew($id);
33 |     }
34 | 
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Libs/Extends/ProxyHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Extends;
 6 | 
 7 | use App\Libs\Config;
 8 | use Closure;
 9 | use DateTimeInterface;
10 | use Monolog\Handler\AbstractProcessingHandler;
11 | use Monolog\Level;
12 | use Monolog\LogRecord;
13 | 
14 | /**
15 |  * ProxyHandler, a handler that calls a closure to process the log record.
16 |  */
17 | final class ProxyHandler extends AbstractProcessingHandler
18 | {
19 |     private bool $closed = false;
20 | 
21 |     public function __construct(private readonly Closure $callback, $level = Level::Debug)
22 |     {
23 |         $this->bubble = true;
24 |         parent::__construct($level, true);
25 |     }
26 | 
27 |     public static function create(Closure $callback, $level = Level::Debug): self
28 |     {
29 |         return new self($callback, $level);
30 |     }
31 | 
32 |     public function close(): void
33 |     {
34 |         $this->closed = true;
35 |     }
36 | 
37 |     protected function write(LogRecord $record): void
38 |     {
39 |         if (true === $this->closed) {
40 |             return;
41 |         }
42 | 
43 |         $date = $record['datetime'] ?? 'No date set';
44 | 
45 |         if (true === ($date instanceof DateTimeInterface)) {
46 |             $date = $date->format(DateTimeInterface::ATOM);
47 |         }
48 | 
49 |         $message = r('[{date}] {level}: {message}', [
50 |             'date' => $date,
51 |             'level' => $record['level_name'] ?? $record['level'] ?? '??',
52 |             'message' => $record['message'],
53 |         ]);
54 | 
55 |         if (false === empty($record['context']) && true === (bool)Config::get('logs.context')) {
56 |             $message .= ' ' . arrayToJson($record['context']);
57 |         }
58 | 
59 |         ($this->callback)($message, $record);
60 |     }
61 | }
62 | 


--------------------------------------------------------------------------------
/src/Libs/Extends/RetryableHttpClient.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Extends;
 6 | 
 7 | use App\Libs\Enums\Http\Method;
 8 | use Symfony\Contracts\HttpClient\ResponseInterface as iResponse;
 9 | 
10 | /**
11 |  * RetryableHttpClient proxy. This Class acts as proxy in front of the Symfony RetryableHttpClient.
12 |  *
13 |  */
14 | class RetryableHttpClient extends \Symfony\Component\HttpClient\RetryableHttpClient
15 | {
16 |     public function request(string|Method $method, string $url, array $options = []): iResponse
17 |     {
18 |         if (true === ($method instanceof Method)) {
19 |             $method = $method->value;
20 |         }
21 | 
22 |         return parent::request($method, $url, $options);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Libs/Extends/RouterStrategy.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Extends;
 6 | 
 7 | use App\Libs\Container;
 8 | use App\Libs\Enums\Http\Status;
 9 | use League\Route\Route;
10 | use League\Route\Strategy\ApplicationStrategy;
11 | use League\Route\Strategy\OptionsHandlerInterface;
12 | use Psr\Container\ContainerExceptionInterface;
13 | use Psr\Container\NotFoundExceptionInterface;
14 | use Psr\Http\Message\ResponseInterface as iResponse;
15 | use Psr\Http\Message\ServerRequestInterface as iRequest;
16 | 
17 | class RouterStrategy extends ApplicationStrategy implements OptionsHandlerInterface
18 | {
19 |     public function getOptionsCallable(array $methods): callable
20 |     {
21 |         $headers = [
22 |             'Allow' => implode(', ', $methods),
23 |         ];
24 | 
25 |         if ('cors' === ag($_SERVER, 'HTTP_SEC_FETCH_MODE')) {
26 |             return fn(): iResponse => addCors(api_response(Status::NO_CONTENT, headers: $headers), $headers, $methods);
27 |         }
28 | 
29 |         return fn(): iResponse => api_response(Status::NO_CONTENT, headers: $headers);
30 |     }
31 | 
32 |     /**
33 |      * @throws ContainerExceptionInterface
34 |      * @throws \ReflectionException
35 |      * @throws NotFoundExceptionInterface
36 |      */
37 |     public function invokeRouteCallable(Route $route, iRequest $request): iResponse
38 |     {
39 |         return $this->decorateResponse(
40 |             Container::get(ReflectionContainer::class)->call(
41 |                 callable: $route->getCallable($this->getContainer()),
42 |                 args: [
43 |                     ...$route->getVars(),
44 |                     iRequest::class => $request,
45 |                     'args' => $route->getVars(),
46 |                 ]
47 |             )
48 |         );
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Libs/Extends/StreamableChunks.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Extends;
 6 | 
 7 | use Generator;
 8 | use IteratorAggregate;
 9 | use Psr\Http\Message\StreamInterface as iStream;
10 | use ReturnTypeWillChange;
11 | 
12 | /**
13 |  * @implements IteratorAggregate<int, string>
14 |  */
15 | class StreamableChunks implements IteratorAggregate
16 | {
17 |     /**
18 |      * @param iStream $stream The stream to be used.
19 |      * @param int $chunkSize The chunk size to be used.
20 |      */
21 |     public function __construct(private iStream $stream, private int $chunkSize = 1024 * 8)
22 |     {
23 |     }
24 | 
25 |     /**
26 |      * Get the iterator.
27 |      *
28 |      * @return Generator
29 |      */
30 |     #[ReturnTypeWillChange]
31 |     public function getIterator(): Generator
32 |     {
33 |         while ('' !== ($chunk = $this->stream->read($this->chunkSize))) {
34 |             yield $chunk;
35 |         }
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Libs/Mappers/Import/ReadOnlyMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Mappers\Import;
 6 | 
 7 | use App\Libs\Entity\StateInterface as iState;
 8 | use App\Libs\Mappers\ImportInterface as iImport;
 9 | 
10 | /**
11 |  * Mapper class based on MemoryMapper with stripped down functionality.
12 |  *
13 |  * @implements iImport
14 |  */
15 | class ReadOnlyMapper extends MemoryMapper implements iImport
16 | {
17 |     private bool $isContainer = false;
18 | 
19 |     public function asContainer(): void
20 |     {
21 |         $this->isContainer = true;
22 |     }
23 | 
24 |     public function add(iState $entity, array $opts = []): MemoryMapper
25 |     {
26 |         if (false === $this->isContainer) {
27 |             return parent::add($entity, $opts);
28 |         }
29 |         $this->objects[] = $entity;
30 |         $pointer = array_key_last($this->objects);
31 |         $this->changed[$pointer] = $pointer;
32 |         $this->addPointers($this->objects[$pointer], $pointer);
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     /**
38 |      * @inheritdoc
39 |      */
40 |     public function remove(iState $entity): bool
41 |     {
42 |         if (false === ($pointer = $this->getPointer($entity))) {
43 |             return false;
44 |         }
45 | 
46 |         $this->removePointers($this->objects[$pointer]);
47 | 
48 |         if (null !== ($this->objects[$pointer] ?? null)) {
49 |             unset($this->objects[$pointer]);
50 |         }
51 | 
52 |         if (null !== ($this->changed[$pointer] ?? null)) {
53 |             unset($this->changed[$pointer]);
54 |         }
55 | 
56 |         return true;
57 |     }
58 | 
59 |     /**
60 |      * @inheritdoc
61 |      */
62 |     public function commit(): array
63 |     {
64 |         $this->reset();
65 | 
66 |         return [
67 |             iState::TYPE_MOVIE => ['added' => 0, 'updated' => 0, 'failed' => 0],
68 |             iState::TYPE_EPISODE => ['added' => 0, 'updated' => 0, 'failed' => 0],
69 |         ];
70 |     }
71 | 
72 |     public function __destruct()
73 |     {
74 |         // -- disabled autocommit.
75 |     }
76 | }
77 | 


--------------------------------------------------------------------------------
/src/Libs/Message.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs;
 6 | 
 7 | /**
 8 |  * Volatile messaging between classes.
 9 |  * This should not be used for anything important.
10 |  * Data is mutable, and can be changed by anything.
11 |  * Messages are not persistent and will be removed once the execution is done.
12 |  */
13 | final class Message
14 | {
15 |     /**
16 |      * @var array $data holds the messages.
17 |      */
18 |     private static array $data = [];
19 | 
20 |     /**
21 |      * Add message to store.
22 |      *
23 |      * @param string $key Message key.
24 |      * @param mixed $value value.
25 |      */
26 |     public static function add(string $key, mixed $value): void
27 |     {
28 |         self::$data = ag_set(self::$data, $key, $value);
29 |     }
30 | 
31 |     /**
32 |      * Get message.
33 |      *
34 |      * @param string $key message key.
35 |      * @param mixed|null $default default value
36 |      *
37 |      * @return mixed
38 |      */
39 |     public static function get(string $key, mixed $default = null): mixed
40 |     {
41 |         return ag(self::$data, $key, $default);
42 |     }
43 | 
44 |     /**
45 |      * Get all stored messages.
46 |      *
47 |      * @return array
48 |      */
49 |     public static function getAll(): array
50 |     {
51 |         return self::$data;
52 |     }
53 | 
54 |     /**
55 |      * increment key value.
56 |      *
57 |      * @param string $key message key.
58 |      * @param int $increment value. default to 1
59 |      */
60 |     public static function increment(string $key, int $increment = 1): void
61 |     {
62 |         self::$data = ag_set(self::$data, $key, $increment + (int)ag(self::$data, $key, 0));
63 |     }
64 | 
65 |     /**
66 |      * Reset stored data.
67 |      */
68 |     public static function reset(): void
69 |     {
70 |         self::$data = [];
71 |     }
72 | }
73 | 


--------------------------------------------------------------------------------
/src/Libs/Middlewares/AddCorsMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Middlewares;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface as iResponse;
 8 | use Psr\Http\Message\ServerRequestInterface as iRequest;
 9 | use Psr\Http\Server\MiddlewareInterface as iMiddleware;
10 | use Psr\Http\Server\RequestHandlerInterface as iHandler;
11 | 
12 | final class AddCorsMiddleware implements iMiddleware
13 | {
14 |     public function process(iRequest $request, iHandler $handler): iResponse
15 |     {
16 |         $response = $handler->handle($request);
17 | 
18 |         if (!$response->hasHeader('Access-Control-Allow-Origin')) {
19 |             $response = $response->withHeader('Access-Control-Allow-Origin', '*');
20 |         }
21 | 
22 |         if (!$response->hasHeader('Access-Control-Allow-Credentials')) {
23 |             $response = $response->withHeader('Access-Control-Allow-Credentials', 'true');
24 |         }
25 | 
26 |         return $response;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Libs/Middlewares/AddTimingMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Middlewares;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface as iResponse;
 8 | use Psr\Http\Message\ServerRequestInterface as iRequest;
 9 | use Psr\Http\Server\MiddlewareInterface as iMiddleware;
10 | use Psr\Http\Server\RequestHandlerInterface as iHandler;
11 | 
12 | final class AddTimingMiddleware implements iMiddleware
13 | {
14 |     public function process(iRequest $request, iHandler $handler): iResponse
15 |     {
16 |         return $handler->handle($request)->withHeader(
17 |             'X-Application-Finished-In',
18 |             round(microtime(true) - APP_START, 6) . 's'
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Libs/Middlewares/ExceptionHandlerMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Middlewares;
 6 | 
 7 | use App\Libs\Enums\Http\Status;
 8 | use Psr\Http\Message\ResponseInterface as iResponse;
 9 | use Psr\Http\Message\ServerRequestInterface as iRequest;
10 | use Psr\Http\Server\MiddlewareInterface as iMiddleware;
11 | use Psr\Http\Server\RequestHandlerInterface as iHandler;
12 | 
13 | final class ExceptionHandlerMiddleware implements iMiddleware
14 | {
15 |     public function process(iRequest $request, iHandler $handler): iResponse
16 |     {
17 |         try {
18 |             return $handler->handle($request);
19 |         } catch (\Throwable $e) {
20 |             return api_error($e->getMessage(), Status::tryFrom($e->getCode()) ?? Status::INTERNAL_SERVER_ERROR);
21 |         }
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Libs/Middlewares/NoAccessLogMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Middlewares;
 6 | 
 7 | use App\Libs\Config;
 8 | use Psr\Http\Message\ResponseInterface as iResponse;
 9 | use Psr\Http\Message\ServerRequestInterface as iRequest;
10 | use Psr\Http\Server\MiddlewareInterface as iMiddleware;
11 | use Psr\Http\Server\RequestHandlerInterface as iHandler;
12 | 
13 | final class NoAccessLogMiddleware implements iMiddleware
14 | {
15 |     public function process(iRequest $request, iHandler $handler): iResponse
16 |     {
17 |         if (false === (bool)$request->getAttribute('INTERNAL_REQUEST', false)) {
18 |             return $handler->handle($request);
19 |         }
20 | 
21 |         if (true === (bool)Config::get('api.logInternal', false)) {
22 |             return $handler->handle($request);
23 |         }
24 | 
25 |         return $handler->handle($request)->withHeader('X-No-AccessLog', '1');
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Libs/Middlewares/ParseJsonBodyMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs\Middlewares;
 6 | 
 7 | use App\Libs\Enums\Http\Method;
 8 | use App\Libs\Enums\Http\Status;
 9 | use JsonException;
10 | use Psr\Http\Message\ResponseInterface as iResponse;
11 | use Psr\Http\Message\ServerRequestInterface as iRequest;
12 | use Psr\Http\Server\MiddlewareInterface as iMiddleware;
13 | use Psr\Http\Server\RequestHandlerInterface as iHandler;
14 | use RuntimeException;
15 | 
16 | class ParseJsonBodyMiddleware implements iMiddleware
17 | {
18 |     public function process(iRequest $request, iHandler $handler): iResponse
19 |     {
20 |         if (null === ($method = Method::tryFrom($request->getMethod()))) {
21 |             throw new RuntimeException(r('Invalid HTTP method. "{method}".', [
22 |                 'method' => $request->getMethod()
23 |             ]), Status::METHOD_NOT_ALLOWED->value);
24 |         }
25 | 
26 |         if (true === in_array($method, [Method::GET, Method::HEAD, Method::OPTIONS])) {
27 |             return $handler->handle($request);
28 |         }
29 | 
30 |         $header = $request->getHeaderLine('Content-Type');
31 | 
32 |         if (1 === preg_match('#^application/(|\S+\+)json($|[ ;])#', $header)) {
33 |             return $handler->handle($this->parse($request));
34 |         }
35 | 
36 |         return $handler->handle($request);
37 |     }
38 | 
39 |     private function parse(iRequest $request): iRequest
40 |     {
41 |         $body = (string)$request->getBody();
42 | 
43 |         if ($request->getBody()->isSeekable()) {
44 |             $request->getBody()->rewind();
45 |         }
46 | 
47 |         if (empty($body)) {
48 |             return $request;
49 |         }
50 | 
51 |         try {
52 |             return $request->withParsedBody(json_decode($body, true, flags: JSON_THROW_ON_ERROR));
53 |         } catch (JsonException $e) {
54 |             throw new RuntimeException(r('Error when parsing JSON request body. {error}', [
55 |                 'error' => $e->getMessage()
56 |             ]), Status::BAD_REQUEST->value, $e);
57 |         }
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/src/Libs/StreamedBody.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types=1);
  4 | 
  5 | namespace App\Libs;
  6 | 
  7 | use Psr\Http\Message\StreamInterface;
  8 | use RuntimeException;
  9 | 
 10 | final readonly class StreamedBody implements StreamInterface
 11 | {
 12 |     private mixed $func;
 13 | 
 14 |     public function __construct(callable $func, private bool $isReadable = true)
 15 |     {
 16 |         $this->func = $func;
 17 |     }
 18 | 
 19 |     public static function create(callable $func, bool $isReadable = true): StreamInterface
 20 |     {
 21 |         return new self($func, isReadable: $isReadable);
 22 |     }
 23 | 
 24 |     public function __destruct()
 25 |     {
 26 |     }
 27 | 
 28 |     public function __toString(): string
 29 |     {
 30 |         return $this->getContents();
 31 |     }
 32 | 
 33 |     public function close(): void
 34 |     {
 35 |     }
 36 | 
 37 |     public function detach(): null
 38 |     {
 39 |         return null;
 40 |     }
 41 | 
 42 |     public function getSize(): ?int
 43 |     {
 44 |         return null;
 45 |     }
 46 | 
 47 |     public function tell(): int
 48 |     {
 49 |         return 0;
 50 |     }
 51 | 
 52 |     public function eof(): bool
 53 |     {
 54 |         return false;
 55 |     }
 56 | 
 57 |     public function isSeekable(): bool
 58 |     {
 59 |         return false;
 60 |     }
 61 | 
 62 |     public function seek($offset, $whence = \SEEK_SET): void
 63 |     {
 64 |     }
 65 | 
 66 |     public function rewind(): void
 67 |     {
 68 |     }
 69 | 
 70 |     public function isWritable(): bool
 71 |     {
 72 |         return false;
 73 |     }
 74 | 
 75 |     public function write($string): int
 76 |     {
 77 |         throw new RuntimeException('Unable to write to a non-writable stream.');
 78 |     }
 79 | 
 80 |     public function isReadable(): bool
 81 |     {
 82 |         return $this->isReadable;
 83 |     }
 84 | 
 85 |     public function read($length): string
 86 |     {
 87 |         return $this->getContents();
 88 |     }
 89 | 
 90 |     public function getContents(): string
 91 |     {
 92 |         return ($this->func)();
 93 |     }
 94 | 
 95 |     public function getMetadata($key = null): null
 96 |     {
 97 |         return null;
 98 |     }
 99 | }
100 | 


--------------------------------------------------------------------------------
/src/Libs/UserContext.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Libs;
 6 | 
 7 | use App\Libs\Attributes\DI\Inject;
 8 | use App\Libs\Database\DatabaseInterface as iDB;
 9 | use App\Libs\Mappers\Import\MemoryMapper;
10 | use App\Libs\Mappers\ImportInterface as iImport;
11 | use Psr\SimpleCache\CacheInterface as iCache;
12 | 
13 | final class UserContext
14 | {
15 |     public readonly iImport $mapper;
16 | 
17 |     /**
18 |      * Make User Context.
19 |      *
20 |      * @param string $name User name.
21 |      * @param ConfigFile $config Per user Configuration file.
22 |      * @param iImport $mapper Per user Data mapper
23 |      * @param iCache $cache Per user cache.
24 |      * @param iDB $db Per user database.
25 |      * @param array $data (Optional) Mutable data for the context.
26 |      */
27 |     public function __construct(
28 |         public readonly string $name,
29 |         public readonly ConfigFile $config,
30 |         #[Inject(MemoryMapper::class)]
31 |         iImport $mapper,
32 |         public readonly iCache $cache,
33 |         public readonly iDB $db,
34 |         public array $data = [],
35 |     ) {
36 |         $this->mapper = $mapper->withUserContext($this);
37 |     }
38 | 
39 |     public function getPath(): string
40 |     {
41 |         if (isset($this->data['path'])) {
42 |             return $this->data['path'];
43 |         }
44 | 
45 |         return fixPath(Config::get('path') . '/' . ('main' === $this->name ? 'config' : "users/{$this->name}"));
46 |     }
47 | 
48 |     public function getBackendsNames(): string
49 |     {
50 |         return join(', ', array_keys($this->config->getAll()));
51 |     }
52 | 
53 |     public function add(string $key, mixed $value): self
54 |     {
55 |         $this->data = ag_set($this->data, $key, $value);
56 |         return $this;
57 |     }
58 | 
59 |     public function get(string $key, mixed $default = null): mixed
60 |     {
61 |         return ag($this->data, $key, $default);
62 |     }
63 | 
64 |     public function has(string $key): bool
65 |     {
66 |         return ag_exists($this->data, $key);
67 |     }
68 | 
69 |     public function remove(string|array $key): self
70 |     {
71 |         $this->data = ag_delete($this->data, $key);
72 |         return $this;
73 |     }
74 | }
75 | 


--------------------------------------------------------------------------------
/src/Model/Base/Enums/ScalarType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Enums;
 4 | 
 5 | enum ScalarType
 6 | {
 7 |     case STRING;
 8 |     case INT;
 9 |     case FLOAT;
10 |     case BOOL;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Model/Base/Enums/TransformType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Enums;
 4 | 
 5 | enum TransformType
 6 | {
 7 |     case ENCODE;
 8 | 
 9 |     case DECODE;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Model/Base/Exceptions/MustBeNonEmpty.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Base\Exceptions;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /**
10 |  * MustBeNonEmpty Thrown when Value is empty.
11 |  *
12 |  * @package Model\Base\Exceptions
13 |  */
14 | class MustBeNonEmpty extends RuntimeException
15 | {
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Model/Base/Exceptions/VDateTypeException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Base\Exceptions;
 6 | 
 7 | /**
 8 |  * VDateTypeException Thrown when DataType check fails.
 9 |  *
10 |  * @package Model\Base\Exceptions
11 |  */
12 | class VDateTypeException extends ValidationException
13 | {
14 | 
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Model/Base/Exceptions/VFilterException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Base\Exceptions;
 6 | 
 7 | /**
 8 |  * VFilterException Thrown when filter fails.
 9 |  *
10 |  * @package Model\Base\Exceptions
11 |  */
12 | class VFilterException extends ValidationException
13 | {
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Model/Base/Exceptions/VValidateException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Base\Exceptions;
 6 | 
 7 | /**
 8 |  * VValidateException Thrown when Custom Validator fails.
 9 |  *
10 |  * @package Model\Base\Exceptions
11 |  */
12 | class VValidateException extends ValidationException
13 | {
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Model/Base/Exceptions/ValidationException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Base\Exceptions;
 6 | 
 7 | use InvalidArgumentException;
 8 | 
 9 | /**
10 |  * All Validation Should Extend this class.
11 |  */
12 | class ValidationException extends InvalidArgumentException
13 | {
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Model/Base/Interfaces/IDInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Interfaces;
 4 | 
 5 | use App\Model\Base\BasicModel;
 6 | 
 7 | interface IDInterface
 8 | {
 9 |     /**
10 |      * Create a new ID.
11 |      *
12 |      * @param BasicModel $model The model to create an ID for.
13 |      *
14 |      * @return int|string
15 |      */
16 |     public function makeId(BasicModel $model): int|string;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Model/Base/Traits/UsesPaging.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Base\Traits;
 6 | 
 7 | trait UsesPaging
 8 | {
 9 |     protected int $start = 0;
10 |     protected int $perpage = 15;
11 |     protected int $total = 0;
12 |     protected string $order = 'DESC';
13 |     protected string $sort = 'id';
14 | 
15 |     public function setStart(int $start = 0): self
16 |     {
17 |         $this->start = $start;
18 | 
19 |         return $this;
20 |     }
21 | 
22 |     public function getStart(): int
23 |     {
24 |         return $this->start;
25 |     }
26 | 
27 |     public function setPerpage(int $perpage = 15): self
28 |     {
29 |         $this->perpage = $perpage;
30 | 
31 |         return $this;
32 |     }
33 | 
34 |     public function getPerpage(): int
35 |     {
36 |         return $this->perpage;
37 |     }
38 | 
39 |     public function setTotal(int $total = 0): self
40 |     {
41 |         $this->total = $total;
42 | 
43 |         return $this;
44 |     }
45 | 
46 |     public function getTotal(): int
47 |     {
48 |         return $this->total;
49 |     }
50 | 
51 |     public function setAscendingOrder(): self
52 |     {
53 |         $this->order = 'ASC';
54 | 
55 |         return $this;
56 |     }
57 | 
58 |     public function setDescendingOrder(): self
59 |     {
60 |         $this->order = 'DESC';
61 | 
62 |         return $this;
63 |     }
64 | 
65 |     public function setSort($field): self
66 |     {
67 |         $this->sort = $field;
68 | 
69 |         return $this;
70 |     }
71 | 
72 |     public function getSort(): string
73 |     {
74 |         return $this->sort;
75 |     }
76 | 
77 |     public function getOrder(): string
78 |     {
79 |         return $this->order;
80 |     }
81 | 
82 | }
83 | 


--------------------------------------------------------------------------------
/src/Model/Base/Transformers/ArrayTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Transformers;
 4 | 
 5 | use App\Model\Base\Enums\TransformType;
 6 | 
 7 | final class ArrayTransformer
 8 | {
 9 |     public function __construct(private bool $nullable = false)
10 |     {
11 |     }
12 | 
13 |     public static function create(bool $nullable = false): callable
14 |     {
15 |         return JSONTransformer::create(isAssoc: true, nullable: $nullable);
16 |     }
17 | 
18 |     public function __invoke(TransformType $type, mixed $data): string|array
19 |     {
20 |         return new JSONTransformer(isAssoc: true, nullable: $this->nullable)(type: $type, data: $data);
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Model/Base/Transformers/DateTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Transformers;
 4 | 
 5 | use App\Model\Base\Enums\TransformType;
 6 | use DateTimeInterface;
 7 | use RuntimeException;
 8 | 
 9 | final readonly class DateTransformer
10 | {
11 |     public function __construct(private bool $nullable = false)
12 |     {
13 |     }
14 | 
15 |     public static function create(bool $nullable = false): callable
16 |     {
17 |         $class = new self($nullable);
18 |         return fn(TransformType $type, mixed $data) => $class($type, $data);
19 |     }
20 | 
21 |     public function __invoke(TransformType $type, mixed $data): string|null|DateTimeInterface
22 |     {
23 |         if (null === $data) {
24 |             if ($this->nullable) {
25 |                 return null;
26 |             }
27 | 
28 |             throw new RuntimeException('Date cannot be null');
29 |         }
30 | 
31 |         $isDate = true === ($data instanceof DateTimeInterface);
32 | 
33 |         if (false === $isDate && !is_string($data)) {
34 |             if (true === ctype_digit((string)$data)) {
35 |                 $isDate = true;
36 |                 $data = makeDate($data);
37 |             } else {
38 |                 throw new RuntimeException('Date must be a string or an instance of DateTimeInterface');
39 |             }
40 |         }
41 | 
42 |         return match ($type) {
43 |             TransformType::ENCODE => $isDate ? $data->format(DateTimeInterface::ATOM) : (string)$data,
44 |             TransformType::DECODE => makeDate($data),
45 |         };
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Model/Base/Transformers/EnumTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Transformers;
 4 | 
 5 | use App\Model\Base\Enums\TransformType;
 6 | use BackedEnum;
 7 | 
 8 | final class EnumTransformer
 9 | {
10 |     /**
11 |      * @param string<class-string> $enumName The class name of the enum.
12 |      */
13 |     public function __construct(private string $enumName)
14 |     {
15 |     }
16 | 
17 |     public static function create(string $enumName): callable
18 |     {
19 |         $class = new self($enumName);
20 |         return fn(TransformType $type, mixed $data) => $class($type, $data);
21 |     }
22 | 
23 |     public function __invoke(TransformType $type, mixed $value): mixed
24 |     {
25 |         return match ($type) {
26 |             TransformType::ENCODE => $this->encode($value),
27 |             TransformType::DECODE => $this->decode($value),
28 |         };
29 |     }
30 | 
31 |     private function encode(mixed $value): string|int
32 |     {
33 |         if (is_string($value) || is_int($value)) {
34 |             return $value;
35 |         }
36 | 
37 |         return $value instanceof BackedEnum ? $value->value : $value->name;
38 |     }
39 | 
40 |     private function decode(mixed $data): mixed
41 |     {
42 |         return is_subclass_of($this->enumName, BackedEnum::class)
43 |             ? ($this->enumName)::from($data)
44 |             : constant($this->enumName . '::' . $data);
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Model/Base/Transformers/JSONTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Transformers;
 4 | 
 5 | use App\Model\Base\Enums\TransformType;
 6 | use InvalidArgumentException;
 7 | 
 8 | final class JSONTransformer
 9 | {
10 |     public const int DEFAULT_JSON_FLAGS = JSON_INVALID_UTF8_IGNORE | JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_AMP | JSON_HEX_QUOT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE;
11 | 
12 |     public function __construct(
13 |         private bool $isAssoc = false,
14 |         private int $flags = self::DEFAULT_JSON_FLAGS,
15 |         private bool $nullable = false,
16 |     ) {
17 |     }
18 | 
19 |     public static function create(
20 |         bool $isAssoc = false,
21 |         int $flags = self::DEFAULT_JSON_FLAGS,
22 |         bool $nullable = false
23 |     ): callable {
24 |         $class = new self(isAssoc: $isAssoc, flags: $flags, nullable: $nullable);
25 |         return fn(TransformType $type, mixed $data) => $class($type, $data);
26 |     }
27 | 
28 |     public function __invoke(TransformType $type, mixed $data): string|array|object|null
29 |     {
30 |         if (null === $data) {
31 |             if (true === $this->nullable) {
32 |                 return null;
33 |             }
34 |             throw new InvalidArgumentException('Data cannot be null');
35 |         }
36 | 
37 |         return match ($type) {
38 |             TransformType::ENCODE => json_encode($data, flags: $this->flags),
39 |             TransformType::DECODE => json_decode($data, associative: $this->isAssoc, flags: $this->flags),
40 |         };
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Model/Base/Transformers/ScalarTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Transformers;
 4 | 
 5 | use App\Model\Base\Enums\ScalarType;
 6 | use App\Model\Base\Enums\TransformType;
 7 | 
 8 | final class ScalarTransformer
 9 | {
10 |     public function __construct(private ScalarType $scalarType)
11 |     {
12 |     }
13 | 
14 |     public static function create(ScalarType $scalarType): callable
15 |     {
16 |         $class = new self($scalarType);
17 |         return fn(TransformType $type, mixed $data) => $class($type, $data);
18 |     }
19 | 
20 |     public function __invoke(TransformType $type, mixed $value): int|string|float|bool
21 |     {
22 |         return match ($type) {
23 |             TransformType::ENCODE => $this->encode($value),
24 |             TransformType::DECODE => $this->decode($value),
25 |         };
26 |     }
27 | 
28 |     private function encode(mixed $value): float|bool|int|string
29 |     {
30 |         return $this->decode($value);
31 |     }
32 | 
33 |     private function decode(mixed $data): float|bool|int|string
34 |     {
35 |         return match ($this->scalarType) {
36 |             ScalarType::STRING => (string)$data,
37 |             ScalarType::INT => (int)$data,
38 |             ScalarType::FLOAT => (float)$data,
39 |             ScalarType::BOOL => (bool)$data,
40 |         };
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Model/Base/Transformers/SerializeTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Transformers;
 4 | 
 5 | use App\Model\Base\Enums\TransformType;
 6 | use Closure;
 7 | 
 8 | final class SerializeTransformer
 9 | {
10 |     private static Closure $encode;
11 |     private static Closure $decode;
12 | 
13 |     public function __construct(bool $allowClasses = true)
14 |     {
15 |         if (extension_loaded('igbinary')) {
16 |             self::$encode = igbinary_serialize(...);
17 |             self::$decode = igbinary_unserialize(...);
18 |         } else {
19 |             self::$encode = serialize(...);
20 |             self::$decode = fn(string $data) => unserialize($data, ['allowed_classes' => $allowClasses]);
21 |         }
22 |     }
23 | 
24 |     public function __invoke(TransformType $type, mixed $data): mixed
25 |     {
26 |         return match ($type) {
27 |             TransformType::ENCODE => (self::$encode)($data),
28 |             TransformType::DECODE => (self::$decode)($data),
29 |         };
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Model/Base/Transformers/TimestampTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Base\Transformers;
 4 | 
 5 | use App\Model\Base\Enums\TransformType;
 6 | use DateTimeInterface;
 7 | use RuntimeException;
 8 | 
 9 | final readonly class TimestampTransformer
10 | {
11 |     public function __construct(private bool $nullable = false)
12 |     {
13 |     }
14 | 
15 |     public static function create(bool $nullable = false): callable
16 |     {
17 |         $class = new self(nullable: $nullable);
18 |         return fn(TransformType $type, mixed $data) => $class($type, $data);
19 |     }
20 | 
21 |     public function __invoke(TransformType $type, mixed $data): string|null|DateTimeInterface
22 |     {
23 |         if (null === $data) {
24 |             if ($this->nullable) {
25 |                 return null;
26 |             }
27 | 
28 |             throw new RuntimeException('Date cannot be null');
29 |         }
30 | 
31 |         $isDate = true === ($data instanceof DateTimeInterface);
32 | 
33 |         if (false === $isDate && !ctype_digit($data)) {
34 |             if (is_string($data)) {
35 |                 $isDate = true;
36 |                 $data = makeDate($data);
37 |             } else {
38 |                 throw new RuntimeException(r("Date must be a integer or DateTime. '{type}('{data}')' given.", [
39 |                     'type' => get_debug_type($data),
40 |                     'data' => $data,
41 |                 ]));
42 |             }
43 |         }
44 | 
45 |         return match ($type) {
46 |             TransformType::ENCODE => $isDate ? $data->getTimestamp() : $data,
47 |             TransformType::DECODE => $isDate ? $data : makeDate($data),
48 |         };
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Model/Events/EventListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Events;
 6 | 
 7 | use Attribute;
 8 | 
 9 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
10 | final readonly class EventListener
11 | {
12 |     /**
13 |      * Listen to an event.
14 |      *
15 |      * @param string $event Event to listen to.
16 |      */
17 |     public function __construct(public string $event)
18 |     {
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Model/Events/EventStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Model\Events;
 4 | 
 5 | enum EventStatus: int
 6 | {
 7 |     case PENDING = 0;
 8 |     case RUNNING = 1;
 9 |     case SUCCESS = 2;
10 |     case FAILED = 3;
11 |     case CANCELLED = 4;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Model/Events/EventValidation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Events;
 6 | 
 7 | use App\Model\Base\BasicValidation;
 8 | use App\Model\Events\Event as EntityItem;
 9 | 
10 | final class EventValidation extends BasicValidation
11 | {
12 |     public function __construct(EntityItem $object)
13 |     {
14 |         $this->runValidator($object);
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Model/Events/EventsTable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Model\Events;
 6 | 
 7 | use App\Model\Base\BasicModel;
 8 | 
 9 | abstract class EventsTable extends BasicModel
10 | {
11 |     public const string TABLE_NAME = 'events';
12 |     public const string TABLE_PRIMARY_KEY = self::COLUMN_ID;
13 | 
14 |     public const string COLUMN_ID = 'id';
15 |     public const string COLUMN_STATUS = 'status';
16 |     public const string COLUMN_REFERENCE = 'reference';
17 |     public const string COLUMN_EVENT = 'event';
18 |     public const string COLUMN_EVENT_DATA = 'event_data';
19 |     public const string COLUMN_OPTIONS = 'options';
20 |     public const string COLUMN_ATTEMPTS = 'attempts';
21 |     public const string COLUMN_LOGS = 'logs';
22 |     public const string COLUMN_CREATED_AT = 'created_at';
23 |     public const string COLUMN_UPDATED_AT = 'updated_at';
24 | }
25 | 


--------------------------------------------------------------------------------
/tests/Fixtures/MovieEntity.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | use App\Libs\Entity\StateInterface as iState;
 6 | use App\Libs\Guid;
 7 | 
 8 | return [
 9 |     iState::COLUMN_ID => null,
10 |     iState::COLUMN_TYPE => iState::TYPE_MOVIE,
11 |     iState::COLUMN_UPDATED => 1,
12 |     iState::COLUMN_WATCHED => 1,
13 |     iState::COLUMN_VIA => 'test_plex',
14 |     iState::COLUMN_TITLE => 'Movie Title',
15 |     iState::COLUMN_YEAR => 2020,
16 |     iState::COLUMN_SEASON => null,
17 |     iState::COLUMN_EPISODE => null,
18 |     iState::COLUMN_PARENT => [],
19 |     iState::COLUMN_GUIDS => [
20 |         Guid::GUID_IMDB => 'tt1100',
21 |         Guid::GUID_TVDB => '1200',
22 |         Guid::GUID_TMDB => '1300',
23 |         Guid::GUID_TVMAZE => '1400',
24 |         Guid::GUID_TVRAGE => '1500',
25 |         Guid::GUID_ANIDB => '1600',
26 |     ],
27 |     iState::COLUMN_META_DATA => [
28 |         'test_plex' => [
29 |             iState::COLUMN_ID => 121,
30 |             iState::COLUMN_TYPE => iState::TYPE_MOVIE,
31 |             iState::COLUMN_WATCHED => 1,
32 |             iState::COLUMN_YEAR => '2020',
33 |             iState::COLUMN_META_DATA_EXTRA => [
34 |                 iState::COLUMN_META_DATA_EXTRA_DATE => '2020-01-03',
35 |             ],
36 |             iState::COLUMN_META_DATA_PROGRESS => 5000,
37 |             iState::COLUMN_META_DATA_ADDED_AT => 1,
38 |             iState::COLUMN_META_DATA_PLAYED_AT => 2,
39 |         ],
40 |     ],
41 |     iState::COLUMN_EXTRA => [
42 |         'test_plex' => [
43 |             iState::COLUMN_EXTRA_EVENT => 'media.scrobble',
44 |             iState::COLUMN_EXTRA_DATE => 2,
45 |         ],
46 |     ],
47 |     iState::COLUMN_CREATED_AT => 2,
48 |     iState::COLUMN_UPDATED_AT => 2,
49 | ];
50 | 


--------------------------------------------------------------------------------
/tests/Fixtures/local_data/fanart.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/tests/Fixtures/local_data/fanart.png


--------------------------------------------------------------------------------
/tests/Fixtures/local_data/poster.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/tests/Fixtures/local_data/poster.jpg


--------------------------------------------------------------------------------
/tests/Fixtures/local_data/test.mkv:
--------------------------------------------------------------------------------
1 | 0
2 | 


--------------------------------------------------------------------------------
/tests/Fixtures/local_data/test.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/arabcoders/watchstate/5cc1c70bd970a6692aea994d78d222d78dce2416/tests/Fixtures/local_data/test.png


--------------------------------------------------------------------------------
/tests/Fixtures/local_data/test.srt:
--------------------------------------------------------------------------------
1 | 0
2 | 


--------------------------------------------------------------------------------
/tests/Fixtures/meminfo_data.txt:
--------------------------------------------------------------------------------
 1 | MemTotal:       131598708 kB
 2 | MemFree:        10636272 kB
 3 | MemAvailable:   113059644 kB
 4 | Buffers:         1851320 kB
 5 | Cached:         96874768 kB
 6 | SwapCached:       199724 kB
 7 | Active:         15252072 kB
 8 | Inactive:       96757496 kB
 9 | Active(anon):    4046452 kB
10 | Inactive(anon): 11604056 kB
11 | Active(file):   11205620 kB
12 | Inactive(file): 85153440 kB
13 | Unevictable:       43880 kB
14 | Mlocked:               0 kB
15 | SwapTotal:      144758584 kB
16 | SwapFree:       140512824 kB
17 | Zswap:                 0 kB
18 | Zswapped:              0 kB
19 | Dirty:                28 kB
20 | Writeback:             0 kB
21 | AnonPages:      12869660 kB
22 | Mapped:           760892 kB
23 | Shmem:           2367028 kB
24 | KReclaimable:    7315620 kB
25 | Slab:            8107296 kB
26 | SReclaimable:    7315620 kB
27 | SUnreclaim:       791676 kB
28 | KernelStack:       42512 kB
29 | PageTables:        78184 kB
30 | SecPageTables:         0 kB
31 | NFS_Unstable:          0 kB
32 | Bounce:                0 kB
33 | WritebackTmp:          0 kB
34 | CommitLimit:    210557936 kB
35 | Committed_AS:   38290840 kB
36 | VmallocTotal:   34359738367 kB
37 | VmallocUsed:      198508 kB
38 | VmallocChunk:          0 kB
39 | Percpu:            37760 kB
40 | HardwareCorrupted:     0 kB
41 | AnonHugePages:   5797888 kB
42 | ShmemHugePages:    47104 kB
43 | ShmemPmdMapped:        0 kB
44 | FileHugePages:         0 kB
45 | FilePmdMapped:         0 kB
46 | HugePages_Total:       0
47 | HugePages_Free:        0
48 | HugePages_Rsvd:        0
49 | HugePages_Surp:        0
50 | Hugepagesize:       2048 kB
51 | Hugetlb:               0 kB
52 | DirectMap4k:    11644304 kB
53 | DirectMap2M:    119123968 kB
54 | DirectMap1G:     3145728 kB
55 | 
56 | 


--------------------------------------------------------------------------------
/tests/Fixtures/static_data/test.css:
--------------------------------------------------------------------------------
1 | html {
2 |     background-color: #f0f0f0;
3 |     font-family: Arial, sans-serif;
4 |     font-size: 16px;
5 |     color: #333;
6 | }
7 | 


--------------------------------------------------------------------------------
/tests/Fixtures/static_data/test.html:
--------------------------------------------------------------------------------
 1 | <!doctype html>
 2 | <html lang="en">
 3 | <head>
 4 |     <meta charset="UTF-8">
 5 |     <meta name="viewport"
 6 |           content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
 7 |     <meta http-equiv="X-UA-Compatible" content="ie=edge">
 8 |     <title>Document</title>
 9 | </head>
10 | <body>
11 | </body>
12 | </html>
13 | 


--------------------------------------------------------------------------------
/tests/Fixtures/static_data/test.js:
--------------------------------------------------------------------------------
1 | const testFunc = () => 'test'
2 | 


--------------------------------------------------------------------------------
/tests/Fixtures/static_data/test.json:
--------------------------------------------------------------------------------
1 | {
2 |     "test": "test"
3 | }
4 | 


--------------------------------------------------------------------------------
/tests/Fixtures/static_data/test.md:
--------------------------------------------------------------------------------
1 | # Test markdown
2 | 


--------------------------------------------------------------------------------
/tests/Fixtures/static_data/test.woff2:
--------------------------------------------------------------------------------
1 | test
2 | 


--------------------------------------------------------------------------------
/tests/Fixtures/static_data/test/index.html:
--------------------------------------------------------------------------------
1 | test_index.html
2 | 


--------------------------------------------------------------------------------
/tests/Fixtures/static_data/test2/test.html:
--------------------------------------------------------------------------------
1 | test
2 | 


--------------------------------------------------------------------------------
/tests/Fixtures/subtitle.exported.vtt:
--------------------------------------------------------------------------------
1 | WEBVTT

00:00:00.498 --> 00:00:02.827
<v Speaker01>- Johnny, where are you?</v>

00:00:02.827 --> 00:00:06.383
<v Speaker02>- Over here</v>
<v Speaker01>- Where?</v>

00:00:06.383 --> 00:00:09.427
Oh, there you are!

00:00:09.427 --> 00:00:12.600
Come over here.
I want to read to you.

00:00:12.600 --> 00:00:16.900
I have your favorite book:
Green Eggs and Ham


--------------------------------------------------------------------------------
/tests/Fixtures/subtitle.json:
--------------------------------------------------------------------------------
 1 | [
 2 |     {
 3 |         "start": 0.498,
 4 |         "end": 2.827,
 5 |         "lines": [
 6 |             "- Johnny, where are you?"
 7 |         ],
 8 |         "vtt": {
 9 |             "speakers": [
10 |                 "Speaker01"
11 |             ]
12 |         }
13 |     },
14 |     {
15 |         "start": 2.827,
16 |         "end": 6.383,
17 |         "lines": [
18 |             "- Over here",
19 |             "- Where?"
20 |         ],
21 |         "vtt": {
22 |             "speakers": [
23 |                 "Speaker02",
24 |                 "Speaker01"
25 |             ]
26 |         }
27 |     },
28 |     {
29 |         "start": 6.383,
30 |         "end": 9.427,
31 |         "lines": [
32 |             "Oh, there you are!"
33 |         ]
34 |     },
35 |     {
36 |         "start": 9.427,
37 |         "end": 12.6,
38 |         "lines": [
39 |             "Come over here.",
40 |             "I want to read to you."
41 |         ]
42 |     },
43 |     {
44 |         "start": 12.6,
45 |         "end": 16.9,
46 |         "lines": [
47 |             "I have your favorite book:",
48 |             "Green Eggs and Ham"
49 |         ]
50 |     }
51 | ]


--------------------------------------------------------------------------------
/tests/Fixtures/subtitle.vtt:
--------------------------------------------------------------------------------
 1 | WEBVTT
 2 | Kind: captions
 3 | Language: en-US
 4 | Channel: CC1
 5 | Station: Online ABC
 6 | ProgramID: SH010855880000
 7 | ProgramType: TV series
 8 | ProgramName: Castle
 9 | Title: Law & Murder
10 | Season: 3
11 | Episode: 19
12 | PublishDate: 2011-03-28
13 | ContentAdvisory: TV-14
14 | 
15 | STYLE
16 | /* Default cue styling */
17 | ::cue {
18 |  background-image: linear-gradient(to bottom, dimgray, lightgray);
19 |  color: blue;
20 |  }
21 | /* Classes that can be applied to individual cues or phrases */
22 | ::cue(.bg-yellow) {
23 |   background-color: yellow;
24 |   }
25 | ::cue(.green) {
26 |   color: green;
27 |   }
28 | 
29 | 
30 | NOTE
31 | Copyright (c) 2016 by XYZ Company
32 | All rights reserved
33 | 
34 | NOTE - Revisions
35 | 05/10/2016 09:20 AM - Revision 1.0 - First draft. TBD: Positioning
36 | 05/13/2016 06:13 PM - Revision 1.1 - Positioning completed.
37 | 05/14/2016 12:25 PM - Revision 1.2 - Review completed. Final draft.
38 | 
39 | NOTE ==== Beginning of Cues ====
40 | 
41 | 00:00:00.498 --> 00:00:02.827
42 | <v Speaker01>- Johnny, where are you?
43 | 
44 | 00:00:02.827 --> 00:00:06.383
45 | <v Speaker02>- <i>Over here</i></v>
46 | <v Speaker01>- Where?</v>
47 | 
48 | 00:00:06.383 --> 00:00:09.427
49 | Oh, <b>there</b> you are!
50 | 
51 | 00:00:09.427 --> 00:00:12.600
52 | Come over here.
53 | I want to read to you.
54 | 
55 | 00:00:12.600 --> 00:00:16.900
56 | I have your favorite book:
57 | <u>Green Eggs and Ham</u>
58 | 
59 | NOTE ==== End of file ====
60 | 


--------------------------------------------------------------------------------
/tests/Fixtures/test_env_vars:
--------------------------------------------------------------------------------
 1 | WS_TZ=Asia/Kuwait
 2 | WS_CRON_IMPORT=1
 3 | WS_CRON_EXPORT=0
 4 | WS_FOO_BAR=" "
 5 | WS_CRON_IMPORT_AT=16 */1 * * *
 6 | WS_CRON_EXPORT_AT="30 */3 * * *"
 7 | WS_CRON_PUSH_AT='*/10 * * * *'
 8 | # Commit_line=foo
 9 | # Next is empty line
10 | 
11 | # Intentionally left "=" from the string
12 | FOOBAR_KAZ
13 | 


--------------------------------------------------------------------------------
/tests/Fixtures/test_servers.yaml:
--------------------------------------------------------------------------------
 1 | test_plex:
 2 |   type: plex
 3 |   url: 'https://plex.example.invalid'
 4 |   token: t000000000000000000p
 5 |   user: 11111111
 6 |   uuid: s00000000000000000000000000000000000000p
 7 |   export:
 8 |     enabled: true
 9 |     lastSync: 1724273445
10 |   import:
11 |     enabled: true
12 |     lastSync: 1724173445
13 |   webhook:
14 |     match:
15 |       user: true
16 |       uuid: true
17 |   options:
18 |     ignore: '22,1,2,3'
19 |     LIBRARY_SEGMENT: 1000
20 |     ADMIN_TOKEN: plex_admin_token
21 |     plex_user_uuid: r00000000000000p
22 | 
23 | test_jellyfin:
24 |   type: jellyfin
25 |   url: 'https://jellyfin.example.invalid'
26 |   token: t000000000000000000000000000000j
27 |   user: u000000000000000000000000000000j
28 |   uuid: s000000000000000000000000000000j
29 |   export:
30 |     enabled: true
31 |     lastSync: null
32 |   import:
33 |     enabled: true
34 |     lastSync: 1724173445
35 |   webhook:
36 |     match:
37 |       user: false
38 |       uuid: true
39 |   options:
40 |     ignore: 'i000000000000000000000000000000j,i100000000000000000000000000000j'
41 |     MAX_EPISODE_RANGE: 6
42 | 
43 | test_emby:
44 |   type: emby
45 |   url: 'https://emby.example.invalid'
46 |   token: t000000000000000000000000000000e
47 |   user: u000000000000000000000000000000e
48 |   uuid: s000000000000000000000000000000e
49 |   import:
50 |     enabled: true
51 |     lastSync: 1724173445
52 |   export:
53 |     enabled: true
54 |     lastSync: null
55 |   webhook:
56 |     match:
57 |       user: false
58 |       uuid: true
59 |   options: { }
60 | 


--------------------------------------------------------------------------------
/tests/Libs/APIResponseTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Libs;
 6 | 
 7 | use App\Libs\APIResponse;
 8 | use App\Libs\Enums\Http\Status;
 9 | use App\Libs\Stream;
10 | use App\Libs\TestCase;
11 | 
12 | class APIResponseTest extends TestCase
13 | {
14 |     public function test_response()
15 |     {
16 |         $body = [
17 |             'id' => 1,
18 |             'name' => 'test',
19 |         ];
20 | 
21 |         $json = json_encode($body);
22 | 
23 |         $response = new APIResponse(Status::OK, headers: [
24 |             'Content-Length' => strlen($json),
25 |             'Content-Type' => 'application/json',
26 |         ], body: $body, stream: Stream::create($json));
27 | 
28 |         $this->assertEquals(Status::OK, $response->status, 'Status is not OK');
29 |         $this->assertEquals($body, $response->body, 'Body is not equal');
30 |         $this->assertEquals($json, $response->stream->getContents(), 'Stream is not equal');
31 |         $this->assertEquals('application/json', ag($response->headers, 'Content-Type'), 'Content-Type is not equal');
32 |         $this->assertTrue($response->hasStream(), 'Stream is not available');
33 |         $this->assertTrue($response->hasBody(), 'Body is not available');
34 |         $this->assertTrue($response->hasHeaders(), 'Headers are not available');
35 |         $this->assertEquals(strlen($json), $response->getHeader('Content-Length'), 'Content-Length is not equal');
36 |         $this->assertSame(1, $response->getParam('id'), 'Param id is not equal');
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/tests/Libs/Enums/Http/MethodTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Libs\Enums\Http;
 6 | 
 7 | use App\Libs\Enums\Http\Method;
 8 | use App\Libs\TestCase;
 9 | 
10 | class MethodTest extends TestCase
11 | {
12 |     public function test_expected_methods()
13 |     {
14 |         $methods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', 'HEAD'];
15 | 
16 |         foreach ($methods as $method) {
17 |             if (null === ($enum = Method::tryfrom($method))) {
18 |                 $this->fail("HTTP Method '{$method}' not recognized.");
19 |             } else {
20 |                 $this->assertEquals(
21 |                     $method,
22 |                     $enum->value,
23 |                     "The return value of 'Method::{$enum->name}' '{$enum->value}' is not the expected value of '{$method}'."
24 |                 );
25 |             }
26 |         }
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/tests/Libs/Enums/Http/StatusTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Libs\Enums\Http;
 6 | 
 7 | use App\Libs\Enums\Http\Status;
 8 | use App\Libs\TestCase;
 9 | 
10 | class StatusTest extends TestCase
11 | {
12 |     /**
13 |      * This test checks if the important status codes are recognized. However, we do not cover the
14 |      * entire range of status codes as it is not feasible to test all of them.
15 |      */
16 |     public function test_important_status_codes()
17 |     {
18 |         $statusCodes = [200, 201, 202, 204, 304, 400, 401, 403, 404, 405, 406, 409, 500, 503, 504, 505];
19 | 
20 |         foreach ($statusCodes as $code) {
21 |             if (null === ($enum = Status::tryfrom($code))) {
22 |                 $this->fail("Important HTTP status code '{$code}' not recognized.");
23 |             } else {
24 |                 $this->assertEquals(
25 |                     $code,
26 |                     $enum->value,
27 |                     "The return value of 'Status::{$enum->name}' '{$enum->value}' is not the expected '{$code}' value."
28 |                 );
29 |             }
30 |         }
31 |     }
32 | 
33 |     /**
34 |      * This test checks if the status code is within the boundary of 100 to 599.
35 |      * This test is needed to trigger an error if the status code is out of the boundary. As some parts
36 |      * of the codebase expect the status code to be within this boundary.
37 |      */
38 |     public function test_status_code_boundary()
39 |     {
40 |         foreach (Status::cases() as $code) {
41 |             $this->assertTrue(
42 |                 $code->value >= 100 && $code->value <= 599,
43 |                 "HTTP Status Code 'Status::{$code->name}' '{$code->value}' is out of boundary."
44 |             );
45 |         }
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/tests/Libs/Middlewares/AddCorsMiddlewareTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Libs\Middlewares;
 6 | 
 7 | use App\Libs\Enums\Http\Status;
 8 | use App\Libs\Middlewares\AddCorsMiddleware;
 9 | use App\Libs\Response;
10 | use App\Libs\TestCase;
11 | use Tests\Support\RequestResponseTrait;
12 | 
13 | class AddCorsMiddlewareTest extends TestCase
14 | {
15 |     use RequestResponseTrait;
16 | 
17 |     public function test_response()
18 |     {
19 |         $result = new AddCorsMiddleware()->process(
20 |             request: $this->getRequest(),
21 |             handler: $this->getHandler(new Response(Status::OK))
22 |         );
23 | 
24 |         $this->assertTrue(
25 |             $result->hasHeader('Access-Control-Allow-Origin'),
26 |             'Access-Control-Allow-Origin is not available'
27 |         );
28 | 
29 |         $this->assertTrue(
30 |             $result->hasHeader('Access-Control-Allow-Credentials'),
31 |             'Access-Control-Allow-Credentials is not available'
32 |         );
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/tests/Libs/Middlewares/ExceptionHandlerMiddlewareTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Libs\Middlewares;
 6 | 
 7 | use App\Libs\Middlewares\ExceptionHandlerMiddleware;
 8 | use App\Libs\TestCase;
 9 | use Tests\Support\RequestResponseTrait;
10 | 
11 | class ExceptionHandlerMiddlewareTest extends TestCase
12 | {
13 |     use RequestResponseTrait;
14 | 
15 |     /** @noinspection PhpUnhandledExceptionInspection */
16 |     public function test_response()
17 |     {
18 |         $result = new ExceptionHandlerMiddleware()->process(
19 |             request: $this->getRequest(),
20 |             handler: $this->getHandler(
21 |                 fn() => throw new \RuntimeException('Test Exception', 404)
22 |             )
23 |         );
24 | 
25 |         $json = json_decode($result->getBody()->getContents(), true, flags: JSON_THROW_ON_ERROR);
26 | 
27 |         $this->assertArrayHasKey('error', $json, 'Error key is not available');
28 |         $this->assertArrayHasKey('message', $json['error'], 'Message key is not available');
29 |         $this->assertArrayHasKey('code', $json['error'], 'Status key is not available');
30 | 
31 |         $this->assertSame('Test Exception', $json['error']['message'], 'Message is not equal');
32 |         $this->assertSame(404, $json['error']['code'], 'Status is not equal');
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/tests/Libs/Middlewares/NoAccessLogMiddlewareTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Libs\Middlewares;
 6 | 
 7 | use App\Libs\Config;
 8 | use App\Libs\Enums\Http\Status;
 9 | use App\Libs\Middlewares\NoAccessLogMiddleware;
10 | use App\Libs\Response;
11 | use App\Libs\TestCase;
12 | use Tests\Support\RequestResponseTrait;
13 | 
14 | class NoAccessLogMiddlewareTest extends TestCase
15 | {
16 |     use RequestResponseTrait;
17 | 
18 |     public function test_response_not_internal_request()
19 |     {
20 |         $result = new NoAccessLogMiddleware()->process(
21 |             request: $this->getRequest(),
22 |             handler: $this->getHandler(new Response(Status::OK))
23 |         );
24 | 
25 |         $this->assertFalse(
26 |             $result->hasHeader('X-No-AccessLog'),
27 |             'If INTERNAL_REQUEST is not set, Logging should be enabled.'
28 |         );
29 |     }
30 | 
31 |     public function test_response_internal_request()
32 |     {
33 |         Config::save('api.logInternal', true);
34 | 
35 |         $result = new NoAccessLogMiddleware()->process(
36 |             request: $this->getRequest()->withAttribute('INTERNAL_REQUEST', true),
37 |             handler: $this->getHandler(new Response(Status::OK))
38 |         );
39 | 
40 |         $this->assertFalse(
41 |             $result->hasHeader('X-No-AccessLog'),
42 |             'If INTERNAL_REQUEST is not set, Logging should be enabled.'
43 |         );
44 | 
45 |         Config::save('api.logInternal', false);
46 |         $result = new NoAccessLogMiddleware()->process(
47 |             request: $this->getRequest()->withAttribute('INTERNAL_REQUEST', true),
48 |             handler: $this->getHandler(new Response(Status::OK))
49 |         );
50 | 
51 |         $this->assertTrue(
52 |             $result->hasHeader('X-No-AccessLog'),
53 |             'If INTERNAL_REQUEST is set and api.logInternal is true, Logging should be disabled.'
54 |         );
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/tests/Libs/VttConverterTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Libs;
 6 | 
 7 | use App\Libs\Stream;
 8 | use App\Libs\TestCase;
 9 | use App\Libs\VttConverter;
10 | 
11 | class VttConverterTest extends TestCase
12 | {
13 |     protected function getData(): string
14 |     {
15 |         return (string)Stream::make(__DIR__ . '/../Fixtures/subtitle.vtt', 'r');
16 |     }
17 | 
18 |     protected function getExportedData(): string
19 |     {
20 |         return (string)Stream::make(__DIR__ . '/../Fixtures/subtitle.exported.vtt', 'r');
21 |     }
22 | 
23 |     protected function getJSON(): array
24 |     {
25 |         return json_decode((string)Stream::make(__DIR__ . '/../Fixtures/subtitle.json', 'r'), true);
26 |     }
27 | 
28 |     public function test_parse()
29 |     {
30 |         $data = VttConverter::parse($this->getData());
31 | 
32 |         $this->assertEquals($this->getJSON(), $data, 'Failed to parse VTT file');
33 |         $this->assertEquals(
34 |             trim(preg_replace('/\r\n|\r|\n/', "\r\n", $this->getExportedData())),
35 |             trim(preg_replace('/\r\n|\r|\n/', "\r\n", VttConverter::export($data))),
36 |             'Failed to export VTT file'
37 |         );
38 |     }
39 | 
40 |     public function test_exceptions()
41 |     {
42 |         $this->checkException(
43 |             closure: function () {
44 |                 $text = <<<VTT
45 |                 WEBVTT
46 | 
47 |                 00:00:14 --> 00:00:21
48 |                 test
49 | 
50 |                 VTT;
51 | 
52 |                 return VttConverter::parse($text);
53 |             },
54 |             reason: 'Invalid VTT file',
55 |             exception: \InvalidArgumentException::class,
56 |         );
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/tests/Mappers/Import/DirectMapperTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Mappers\Import;
 6 | 
 7 | use App\Libs\Entity\StateEntity;
 8 | use App\Libs\Mappers\Import\DirectMapper;
 9 | use App\Libs\Mappers\ImportInterface;
10 | use Symfony\Component\Cache\Adapter\NullAdapter;
11 | use Symfony\Component\Cache\Psr16Cache;
12 | 
13 | class DirectMapperTest extends MapperAbstract
14 | {
15 |     protected function setupMapper(): ImportInterface
16 |     {
17 |         $mapper = new DirectMapper($this->logger, $this->db, cache: new Psr16Cache(new NullAdapter()));
18 |         $mapper->setOptions(options: ['class' => new StateEntity([])]);
19 |         return $mapper;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/tests/Mappers/Import/MemoryMapperTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Tests\Mappers\Import;
 6 | 
 7 | use App\Libs\Entity\StateEntity;
 8 | use App\Libs\Mappers\Import\MemoryMapper;
 9 | use App\Libs\Mappers\ImportInterface;
10 | use Symfony\Component\Cache\Adapter\NullAdapter;
11 | use Symfony\Component\Cache\Psr16Cache;
12 | 
13 | class MemoryMapperTest extends MapperAbstract
14 | {
15 |     protected function setupMapper(): ImportInterface
16 |     {
17 |         $mapper = new MemoryMapper($this->logger, $this->db, new Psr16Cache(new NullAdapter()));
18 |         $mapper->setOptions(options: ['class' => new StateEntity([])]);
19 | 
20 |         return $mapper;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/tests/Server/resources/index.html:
--------------------------------------------------------------------------------
 1 | <!doctype html>
 2 | <html lang="en">
 3 | <head>
 4 |     <meta charset="UTF-8">
 5 |     <meta name="viewport"
 6 |           content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
 7 |     <meta http-equiv="X-UA-Compatible" content="ie=edge">
 8 |     <title>Document</title>
 9 | </head>
10 | <body>
11 | </body>
12 | </html>
13 | 


--------------------------------------------------------------------------------
/tests/Server/resources/index.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | echo 'HelloTester';
4 | 


--------------------------------------------------------------------------------
/tests/bootstrap.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | if (false === defined('IN_TEST_MODE')) {
 6 |     define('IN_TEST_MODE', true);
 7 | }
 8 | 
 9 | const TESTS_PATH = __DIR__;
10 | 
11 | require __DIR__ . '/../pre_init.php';
12 | 
13 | if (!file_exists(__DIR__ . '/../vendor/autoload.php')) {
14 |     fwrite(STDERR, 'Composer dependencies are missing. Run the following commands.' . PHP_EOL);
15 |     fwrite(STDERR, sprintf('cd %s', dirname(__DIR__)) . PHP_EOL);
16 |     fwrite(STDERR, 'composer install --optimize-autoloader' . PHP_EOL);
17 |     exit(1);
18 | }
19 | 
20 | require __DIR__ . '/../vendor/autoload.php';
21 | 
22 | 


--------------------------------------------------------------------------------
/var/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | 


--------------------------------------------------------------------------------