├── .eslintrc.cjs
├── .github
    └── workflows
    │   ├── github-pages.yml
    │   └── unit_tests.yaml
├── .gitignore
├── .php-cs-fixer.php
├── LICENSE
├── Makefile
├── README.md
├── app
    ├── README.md
    └── Template
    │   ├── Component.php
    │   ├── Component
    │       ├── StaticPageBreadcrumbs.php
    │       ├── StaticPageDocumentTableOfContents.php
    │       └── StaticPageDocumentsMenu.php
    │   ├── StaticPageLayout.php
    │   └── StaticPageLayout
    │       ├── Turbo.php
    │       └── Turbo
    │           ├── Document.php
    │           ├── Page.php
    │           ├── Tutorial.php
    │           └── TutorialList.php
├── bin
    └── resonance.php
├── composer.json
├── composer.lock
├── config.ini.example
├── constants.php
├── container.php
├── docs
    ├── .gitignore
    ├── .nojekyll
    ├── CNAME
    └── pages
    │   ├── community
    │       └── index.md
    │   ├── docs
    │       ├── changelog
    │       │   └── index.md
    │       ├── extras
    │       │   ├── index.md
    │       │   └── ssl-certificate-for-local-development
    │       │   │   └── index.md
    │       ├── features
    │       │   ├── ai
    │       │   │   ├── index.md
    │       │   │   ├── machine-learning
    │       │   │   │   └── index.md
    │       │   │   ├── prompt-subject-responders
    │       │   │   │   └── index.md
    │       │   │   ├── prompt-templates
    │       │   │   │   ├── chatml
    │       │   │   │   │   └── index.md
    │       │   │   │   ├── gemma
    │       │   │   │   │   └── index.md
    │       │   │   │   ├── index.md
    │       │   │   │   ├── mistral-instruct
    │       │   │   │   │   └── index.md
    │       │   │   │   └── phi-2
    │       │   │   │   │   └── index.md
    │       │   │   └── server
    │       │   │   │   ├── index.md
    │       │   │   │   └── llama-cpp
    │       │   │   │       ├── extractors
    │       │   │   │           ├── index.md
    │       │   │   │           ├── subject
    │       │   │   │           │   └── index.md
    │       │   │   │           ├── when
    │       │   │   │           │   └── index.md
    │       │   │   │           └── yes-no-maybe
    │       │   │   │           │   └── index.md
    │       │   │   │       └── index.md
    │       │   ├── asset-bundling-esbuild
    │       │   │   ├── accessing-entrypoints-in-php.md
    │       │   │   ├── cache-busting.md
    │       │   │   ├── index.md
    │       │   │   └── preloading-assets.md
    │       │   ├── configuration
    │       │   │   └── index.md
    │       │   ├── console
    │       │   │   └── index.md
    │       │   ├── conversational-applications
    │       │   │   ├── dialogue-nodes
    │       │   │   │   └── index.md
    │       │   │   └── index.md
    │       │   ├── database
    │       │   │   ├── doctrine
    │       │   │   │   ├── console.md
    │       │   │   │   ├── entities.md
    │       │   │   │   ├── entity-managers.md
    │       │   │   │   ├── events.md
    │       │   │   │   └── index.md
    │       │   │   ├── index.md
    │       │   │   ├── migrations
    │       │   │   │   └── index.md
    │       │   │   └── swoole
    │       │   │   │   ├── connection-pools.md
    │       │   │   │   ├── database-entities.md
    │       │   │   │   ├── database-queries.md
    │       │   │   │   ├── index.md
    │       │   │   │   └── reusing-database-queries.md
    │       │   ├── dependency-injection
    │       │   │   └── index.md
    │       │   ├── events
    │       │   │   └── index.md
    │       │   ├── generating-static-sites
    │       │   │   ├── deploying-to-github-pages.md
    │       │   │   ├── index.md
    │       │   │   ├── markdown-extensions.md
    │       │   │   ├── page-structure.md
    │       │   │   └── providing-layouts.md
    │       │   ├── graphql
    │       │   │   ├── developing-schema.md
    │       │   │   ├── index.md
    │       │   │   ├── merging-sql-queries.md
    │       │   │   ├── reusing-database-queries.md
    │       │   │   └── standalone-promise-adapter.md
    │       │   ├── grpc
    │       │   │   ├── client
    │       │   │   │   └── index.md
    │       │   │   └── index.md
    │       │   ├── http
    │       │   │   ├── controllers.md
    │       │   │   ├── index.md
    │       │   │   ├── interceptors.md
    │       │   │   ├── middleware.md
    │       │   │   ├── pipe-messages.md
    │       │   │   ├── responders.md
    │       │   │   ├── routing.md
    │       │   │   ├── server.md
    │       │   │   ├── serving-assets.md
    │       │   │   └── sessions.md
    │       │   ├── index.md
    │       │   ├── mail
    │       │   │   └── index.md
    │       │   ├── observability
    │       │   │   ├── index.md
    │       │   │   └── observable-task-table
    │       │   │   │   └── index.md
    │       │   ├── security
    │       │   │   ├── authentication
    │       │   │   │   └── index.md
    │       │   │   ├── authorization
    │       │   │   │   └── index.md
    │       │   │   ├── content-security-policy
    │       │   │   │   └── index.md
    │       │   │   ├── csrf-protection
    │       │   │   │   └── index.md
    │       │   │   ├── index.md
    │       │   │   └── oauth2
    │       │   │   │   ├── authorization-code-grant
    │       │   │   │       └── index.md
    │       │   │   │   ├── configuration
    │       │   │   │       └── index.md
    │       │   │   │   ├── enabling-grants
    │       │   │   │       └── index.md
    │       │   │   │   ├── index.md
    │       │   │   │   ├── installation
    │       │   │   │       └── index.md
    │       │   │   │   └── persistent-data
    │       │   │   │       └── index.md
    │       │   ├── server-side-rendering
    │       │   │   └── index.md
    │       │   ├── swoole-futures
    │       │   │   ├── index.md
    │       │   │   └── standalone-usage.md
    │       │   ├── swoole-server-tasks
    │       │   │   └── index.md
    │       │   ├── templating
    │       │   │   ├── index.md
    │       │   │   ├── php-templates
    │       │   │   │   └── index.md
    │       │   │   └── twig
    │       │   │   │   ├── index.md
    │       │   │   │   ├── registering-extensions.md
    │       │   │   │   ├── registering-template-loaders.md
    │       │   │   │   └── rendering-templates.md
    │       │   ├── timers
    │       │   │   ├── cron
    │       │   │   │   └── index.md
    │       │   │   ├── index.md
    │       │   │   └── tick-timer
    │       │   │   │   └── index.md
    │       │   ├── translations
    │       │   │   └── index.md
    │       │   ├── validation
    │       │   │   ├── constraints
    │       │   │   │   └── index.md
    │       │   │   ├── form-models
    │       │   │   │   └── index.md
    │       │   │   ├── http-controller-parameters
    │       │   │   │   └── index.md
    │       │   │   └── index.md
    │       │   ├── vector-store
    │       │   │   ├── index.md
    │       │   │   └── sqlite-vss
    │       │   │   │   └── index.md
    │       │   └── websockets
    │       │   │   ├── index.md
    │       │   │   ├── protocols.md
    │       │   │   └── server.md
    │       ├── getting-started
    │       │   ├── index.md
    │       │   ├── installation-and-requirements.md
    │       │   └── resonances-goals-and-principles.md
    │       └── index.md
    │   ├── index.md
    │   ├── swoole
    │       └── index.md
    │   ├── tutorials
    │       ├── basic-graphql-schema
    │       │   └── index.md
    │       ├── hello-world
    │       │   └── index.md
    │       ├── how-to-create-llm-websocket-chat-with-llama-cpp
    │       │   └── index.md
    │       ├── how-to-serve-llm-completions
    │       │   └── index.md
    │       ├── how-to-setup-postfix-for-outgoing-emails
    │       │   └── index.md
    │       ├── index.md
    │       ├── oauth2-server
    │       │   └── index.md
    │       ├── retrieval-augmented-generation-with-resonance-and-rubixml
    │       │   └── index.md
    │       ├── semi-scripted-conversational-applications
    │       │   └── index.md
    │       └── session-based-authentication
    │       │   └── index.md
    │   └── use-cases
    │       └── index.md
├── examples
    └── machine-learning
    │   ├── .gitignore
    │   ├── README.md
    │   ├── app
    │       ├── Command
    │       │   └── TrainIris.php
    │       ├── HtmlErrorTemplate.php
    │       ├── HttpResponder
    │       │   └── Predict.php
    │       ├── UserRepository.php
    │       ├── lang
    │       │   └── en
    │       │   │   └── error.ini
    │       └── views
    │       │   ├── error.twig
    │       │   └── homepage.twig
    │   ├── bin
    │       ├── doctrine.php
    │       └── resonance.php
    │   ├── composer.json
    │   ├── composer.lock
    │   ├── config.ini.example
    │   ├── constants.php
    │   ├── container.php
    │   ├── datasets
    │       └── iris.ndjson
    │   ├── models
    │       └── .gitignore
    │   ├── psalm.xml
    │   └── tools
    │       └── psalm
    │           ├── .gitignore
    │           ├── composer.json
    │           └── composer.lock
├── package.json
├── phpunit.xml
├── phpunit_bootstrap.php
├── psalm.xml
├── rector.php
├── resources
    ├── css
    │   ├── _fonts.css
    │   ├── _reset.css
    │   ├── docs-breadcrumbs.css
    │   ├── docs-common.css
    │   ├── docs-formatted-content.css
    │   ├── docs-hljs.css
    │   ├── docs-links-group.css
    │   ├── docs-page-document.css
    │   ├── docs-page-homepage.css
    │   └── docs-page-tutorial.css
    ├── icons
    │   ├── circle-info-000000.svg
    │   ├── fire-000000.svg
    │   ├── info-000000.svg
    │   ├── lightbulb-000000.svg
    │   ├── plug-circle-plus-333333.svg
    │   ├── search-000000.svg
    │   ├── triangle-exclamation-000000.svg
    │   └── up-right-from-square-fbb829.svg
    ├── images
    │   ├── amphp.webp
    │   ├── chatgpt.webp
    │   ├── favicon.ico
    │   ├── ogimage.webp
    │   ├── openswoole.png
    │   ├── resonance_cat.webp
    │   ├── rubixml.png
    │   ├── swoole.png
    │   └── zork.png
    └── ts
    │   ├── app
    │       ├── EventIterator.ts
    │       ├── Logger.ts
    │       ├── LoggerInterface.ts
    │       ├── MainLoopIterator.ts
    │       └── createLogger.ts
    │   ├── configureTurbo.ts
    │   ├── docs
    │       ├── controller_article.ts
    │       ├── controller_aside-filter.ts
    │       ├── controller_aside.ts
    │       ├── controller_graphviz.ts
    │       ├── controller_hljs.ts
    │       ├── controller_mermaid.ts
    │       ├── controller_minimap.ts
    │       ├── global_stimulus.ts
    │       └── global_turbo.ts
    │   └── stimulus.ts
├── src
    ├── AcceptHeader.php
    ├── AcceptHeaderTest.php
    ├── ApplicationConfiguration.php
    ├── ArrayFlattenIterator.php
    ├── ArrayFlattenIteratorTest.php
    ├── AssetFileRegistry.php
    ├── Attribute.php
    ├── Attribute
    │   ├── Can.php
    │   ├── ConsoleCommand.php
    │   ├── ContentSecurityPolicy.php
    │   ├── ControlsWebSocketProtocol.php
    │   ├── CrudActionSubject.php
    │   ├── CurrentRequest.php
    │   ├── CurrentResponse.php
    │   ├── DecidesCrudAction.php
    │   ├── DecidesSiteAction.php
    │   ├── DoctrineEntityManager.php
    │   ├── DoctrineEntityRepository.php
    │   ├── DoctrineEntityRouteParameter.php
    │   ├── ExtractsOpenAPIMetadataResponse.php
    │   ├── ExtractsOpenAPIMetadataSecurityRequirement.php
    │   ├── ExtractsOpenAPIRouteParameter.php
    │   ├── ExtractsOpenAPIRouteRequestBody.php
    │   ├── ExtractsOpenAPIRouteSecurityRequirement.php
    │   ├── GrantsFeature.php
    │   ├── GraphQLRootField.php
    │   ├── HandlesMiddlewareAttribute.php
    │   ├── HandlesServerPipeMessage.php
    │   ├── HandlesServerTask.php
    │   ├── Intercepts.php
    │   ├── ListensTo.php
    │   ├── ListensToDoctrineEntityEvents.php
    │   ├── ListensToDoctrineEvents.php
    │   ├── OnParameterResolution.php
    │   ├── ProvidesAuthenticatedUser.php
    │   ├── ProvidesOAuth2Grant.php
    │   ├── ProvidesOAuth2Scope.php
    │   ├── ProvidesRouteParameter.php
    │   ├── RequiresOAuth2Scope.php
    │   ├── RequiresPhpExtension.php
    │   ├── RequiresSingletonCollection.php
    │   ├── ResolvesHttpControllerParameter.php
    │   ├── RespondsToHttp.php
    │   ├── RespondsToOAuth2Endpoint.php
    │   ├── RespondsToPromptSubject.php
    │   ├── RespondsToWebSocketJsonRPC.php
    │   ├── RouteParameter.php
    │   ├── ScheduledWithCron.php
    │   ├── ScheduledWithTickTimer.php
    │   ├── SessionAuthenticated.php
    │   ├── SideEffect.php
    │   ├── Singleton.php
    │   ├── StaticPageLayout.php
    │   ├── TwigExtension.php
    │   ├── TwigFilter.php
    │   ├── TwigFunction.php
    │   ├── TwigLoader.php
    │   ├── ValidatedRequest.php
    │   ├── ValidatesCSRFToken.php
    │   ├── WantsFeature.php
    │   └── WebSocketAware.php
    ├── AuthenticatedUser.php
    ├── AuthenticatedUserSource.php
    ├── AuthenticatedUserStoreAggregate.php
    ├── AuthenticatedUserStoreInterface.php
    ├── BackusNaurFormGrammar.php
    ├── BackusNaurFormGrammar
    │   ├── InlineGrammar.php
    │   ├── SubjectActionGrammar.php
    │   ├── YesNoGrammar.php
    │   └── YesNoMaybeGrammar.php
    ├── CSPNonceManager.php
    ├── CSRFManager.php
    ├── CastableEnumTrait.php
    ├── CastsValidatedDataInterface.php
    ├── Command.php
    ├── Command
    │   ├── Cron.php
    │   ├── GenerateDefuseKey.php
    │   ├── GenerateHttpController.php
    │   ├── GenerateHttpResponder.php
    │   ├── GrpcGenerate.php
    │   ├── GrpcRewrite.php
    │   ├── LlamaCppGenerate.php
    │   ├── LlamaCppGenerate
    │   │   ├── Completion.php
    │   │   └── Embedding.php
    │   ├── LlamaCppHealth.php
    │   ├── LlamaCppInfill.php
    │   ├── MailSend.php
    │   ├── PostfixBounce.php
    │   ├── Serve.php
    │   ├── StaticPagesBuild.php
    │   ├── StaticPagesDumpContent.php
    │   ├── StaticPagesMakeEmbeddings.php
    │   └── Watch.php
    ├── CommandLoader.php
    ├── CommonMarkAdmonitionBlock.php
    ├── CommonMarkAdmonitionBlockParser.php
    ├── CommonMarkAdmonitionBlockStartParser.php
    ├── CommonMarkAdmonitionExtension.php
    ├── CommonMarkAdmonitionRenderer.php
    ├── CommonMarkEmbedAdapter.php
    ├── CommonMarkFencedCodeRenderer.php
    ├── CommonMarkInlineCodeRenderer.php
    ├── CommonMarkRenderedContentWithTableOfContentsLinks.php
    ├── CommonMarkTableOfContentsBuilder.php
    ├── CommonMarkTableOfContentsLink.php
    ├── ConfigurationFile.php
    ├── ConsoleApplication.php
    ├── Constraint.php
    ├── Constraint
    │   ├── AnyConstraint.php
    │   ├── AnyConstraintTest.php
    │   ├── AnyOfConstraint.php
    │   ├── AnyOfConstraintTest.php
    │   ├── BooleanConstraint.php
    │   ├── BooleanConstraintTest.php
    │   ├── ConstConstraint.php
    │   ├── ConstConstraintTest.php
    │   ├── EnumConstraint.php
    │   ├── EnumConstraintTest.php
    │   ├── FilenameConstraint.php
    │   ├── FilenameConstraintTest.php
    │   ├── IntegerConstraint.php
    │   ├── IntegerConstraintTest.php
    │   ├── ListConstraint.php
    │   ├── ListConstraintTest.php
    │   ├── MapConstraint.php
    │   ├── MapConstraintTest.php
    │   ├── NumberConstraint.php
    │   ├── NumberConstraintTest.php
    │   ├── ObjectConstraint.php
    │   ├── ObjectConstraintTest.php
    │   ├── StringConstraint.php
    │   ├── StringConstraintTest.php
    │   ├── TupleConstraint.php
    │   └── TupleConstraintTest.php
    ├── ConstraintDefaultValue.php
    ├── ConstraintPath.php
    ├── ConstraintReason.php
    ├── ConstraintResult.php
    ├── ConstraintResultErrorMessage.php
    ├── ConstraintResultStatus.php
    ├── ConstraintSourceInterface.php
    ├── ConstraintStringFormat.php
    ├── ConstraintValidationException.php
    ├── ConstructorParametersIterator.php
    ├── ContentSecurityPolicyDirectives.php
    ├── ContentSecurityPolicyRequestRules.php
    ├── ContentSecurityPolicyRulesRepository.php
    ├── ContentSecurityPolicyType.php
    ├── ContentType.php
    ├── ContentTypeResponder.php
    ├── CookieManager.php
    ├── CoroutineCommand.php
    ├── CronJob.php
    ├── CronJobAggregate.php
    ├── CronJobInterface.php
    ├── CronJobRunner.php
    ├── CronRegisteredJob.php
    ├── CronScheduler.php
    ├── CrudAction.php
    ├── CrudActionGate.php
    ├── CrudActionGateAggregate.php
    ├── CrudActionGateInterface.php
    ├── CrudActionSubjectInterface.php
    ├── CurlErrorMessage.php
    ├── CurlException.php
    ├── DatabaseConfiguration.php
    ├── DatabaseConnection.php
    ├── DatabaseConnectionPoolConfiguration.php
    ├── DatabaseConnectionPoolDriverName.php
    ├── DatabaseConnectionPoolRepository.php
    ├── DatabaseEntity.php
    ├── DatabaseEntityInterface.php
    ├── DatabaseExecutedStatement.php
    ├── DatabasePreparedStatement.php
    ├── DatabaseQuery.php
    ├── DatabaseQueryInterface.php
    ├── DatabaseQueryLogger.php
    ├── DependencyInjectionContainer.php
    ├── DependencyInjectionContainerException.php
    ├── DependencyInjectionContainerException
    │   ├── AmbiguousProvider.php
    │   ├── DependencyCycle.php
    │   ├── DisabledFeatureProvider.php
    │   ├── MissingPhpExtensions.php
    │   └── MissingProvider.php
    ├── DependencyProvider.php
    ├── DependencyProviderIterator.php
    ├── DependencyStack.php
    ├── DialogueController.php
    ├── DialogueControllerInterface.php
    ├── DialogueInput.php
    ├── DialogueInput
    │   └── UserInput.php
    ├── DialogueInputInterface.php
    ├── DialogueMessageChunk.php
    ├── DialogueMessageProducer.php
    ├── DialogueMessageProducer
    │   ├── ConstMessageProducer.php
    │   ├── ConstMessageProducerTest.php
    │   ├── EmptyMessageProducer.php
    │   └── LlamaCppPromptMessageProducer.php
    ├── DialogueMessageProducerInterface.php
    ├── DialogueNode.php
    ├── DialogueNodeInterface.php
    ├── DialogueNodeSideEffect.php
    ├── DialogueNodeSideEffectInterface.php
    ├── DialogueNodeTest.php
    ├── DialogueResponse.php
    ├── DialogueResponse
    │   ├── CatchAllResponse.php
    │   ├── LiteralInputResponse.php
    │   ├── LlamaCppExtractSubjectResponse.php
    │   ├── LlamaCppExtractWhenResponse.php
    │   └── LlamaCppExtractYesNoMaybeResponse.php
    ├── DialogueResponseInterface.php
    ├── DialogueResponseResolution.php
    ├── DialogueResponseResolutionInterface.php
    ├── DialogueResponseResolutionStatus.php
    ├── DialogueResponseSortedIterator.php
    ├── DialogueResponseSortedIteratorTest.php
    ├── DoctrineAttributeDriver.php
    ├── DoctrineConnectionRepository.php
    ├── DoctrineConsoleEntityManagerProvider.php
    ├── DoctrineConsoleRunner.php
    ├── DoctrineDriverConnectTrait.php
    ├── DoctrineEntityListener.php
    ├── DoctrineEntityListenerCollection.php
    ├── DoctrineEntityListenerResolver.php
    ├── DoctrineEntityManagerRepository.php
    ├── DoctrineEntityManagerWeakStore.php
    ├── DoctrineEventSubscriber.php
    ├── DoctrineEventSubscriber
    │   └── RegisterEntityListeners.php
    ├── DoctrineMySQLDriver.php
    ├── DoctrinePostgreSQLDriver.php
    ├── DoctrineSQLiteDriver.php
    ├── EntityManagerWeakReference.php
    ├── EnumValuesTrait.php
    ├── Environment.php
    ├── ErrorHttpResponderDependencies.php
    ├── ErrorTemplateInterface.php
    ├── EsbuildMeta.php
    ├── EsbuildMetaBuilder.php
    ├── EsbuildMetaEntryPoints.php
    ├── EsbuildMetaPreloadsRenderer.php
    ├── EsbuildPreloadable.php
    ├── EsbuildPreloadableType.php
    ├── EsbuildPreloadablesIterator.php
    ├── Event.php
    ├── Event
    │   ├── HttpResponseReady.php
    │   ├── HttpServerBeforeStop.php
    │   ├── HttpServerStarted.php
    │   ├── MailBounced.php
    │   └── UnhandledException.php
    ├── EventDispatcher.php
    ├── EventDispatcherInterface.php
    ├── EventListener.php
    ├── EventListener
    │   ├── CloseDoctrineConnection.php
    │   ├── CloseWebSocketConnections.php
    │   ├── LogRequest.php
    │   ├── PersistSession.php
    │   └── ReportThrowableToLogger.php
    ├── EventListenerAggregate.php
    ├── EventListenerInterface.php
    ├── Feature.php
    ├── FeatureInterface.php
    ├── FooInterface.php
    ├── FrontMatterCollectionReference.php
    ├── Gatekeeper.php
    ├── GatekeeperRequestContext.php
    ├── GatekeeperUserContext.php
    ├── GeneratorHelper.php
    ├── GraphQLAdapter.php
    ├── GraphQLDatabaseQueryAdapter.php
    ├── GraphQLExecutionPromise.php
    ├── GraphQLFieldableInterface.php
    ├── GraphQLResolverException.php
    ├── GraphQLResolverException
    │   ├── Forbidden.php
    │   └── InvalidReturnType.php
    ├── GraphQLReusableDatabaseQueryInterface.php
    ├── GraphQLRootFieldType.php
    ├── GraphQLSchemaRootFieldInterface.php
    ├── GrpcBaseClient.php
    ├── GrpcConfiguration.php
    ├── GrpcPoolConfiguration.php
    ├── HtmlErrorTemplateInterface.php
    ├── HttpControllerDependencies.php
    ├── HttpControllerMetadataException.php
    ├── HttpControllerParameter.php
    ├── HttpControllerParameterResolution.php
    ├── HttpControllerParameterResolutionStatus.php
    ├── HttpControllerParameterResolver.php
    ├── HttpControllerParameterResolver
    │   ├── CurrentRequestResolver.php
    │   ├── CurrentResponseResolver.php
    │   ├── DoctrineEntityManagerResolver.php
    │   ├── DoctrineEntityRepositoryResolver.php
    │   ├── DoctrineEntityRouteParameterResolver.php
    │   ├── RouteParameterResolver.php
    │   ├── SessionAuthenticatedResolver.php
    │   └── ValidatedRequestResolver.php
    ├── HttpControllerParameterResolverAggregate.php
    ├── HttpControllerParameterResolverInterface.php
    ├── HttpControllerReflectionMethod.php
    ├── HttpControllerRequestHandler.php
    ├── HttpError.php
    ├── HttpError
    │   ├── BadRequest.php
    │   ├── Forbidden.php
    │   ├── MethodNotAllowed.php
    │   ├── PageNotFound.php
    │   └── ServerError.php
    ├── HttpInterceptableInterface.php
    ├── HttpInterceptor.php
    ├── HttpInterceptor
    │   ├── InternalRedirectInterceptor.php
    │   ├── JsonTemplateInterceptor.php
    │   ├── OAuth2UserSessionAuthenticatedInterceptor.php
    │   └── TwigTemplateInterceptor.php
    ├── HttpInterceptorAggregate.php
    ├── HttpInterceptorInterface.php
    ├── HttpMiddleware.php
    ├── HttpMiddleware
    │   ├── CanMiddleware.php
    │   ├── ContentSecurityPolicyMiddleware.php
    │   ├── RequiresOAuth2ScopeMiddleware.php
    │   ├── RespondsToOAuth2EndpointMiddleware.php
    │   └── ValidatesCSRFTokenMiddleware.php
    ├── HttpMiddlewareAggregate.php
    ├── HttpMiddlewareAttribute.php
    ├── HttpMiddlewareInterface.php
    ├── HttpRecursiveResponder.php
    ├── HttpRequestData.php
    ├── HttpRequestLanguageDetector.php
    ├── HttpResponder.php
    ├── HttpResponder
    │   ├── Error.php
    │   ├── Error
    │   │   ├── BadRequest.php
    │   │   ├── Forbidden.php
    │   │   ├── MethodNotAllowed.php
    │   │   ├── PageNotFound.php
    │   │   └── ServerError.php
    │   ├── FunctionResponder.php
    │   ├── GraphQL.php
    │   ├── HttpController.php
    │   ├── Json.php
    │   ├── NotAcceptable.php
    │   ├── OAuth2.php
    │   ├── OAuth2
    │   │   ├── AccessToken.php
    │   │   └── Authorization.php
    │   ├── Override.php
    │   └── Redirect.php
    ├── HttpResponderAggregate.php
    ├── HttpResponderCollection.php
    ├── HttpResponderInterface.php
    ├── HttpResponderLoggableInterface.php
    ├── HttpResponderWithAttribute.php
    ├── HttpRouteMatch.php
    ├── HttpRouteMatchRegistry.php
    ├── HttpRouteMatchStatus.php
    ├── HttpRouteParameterBinderAggregate.php
    ├── HttpRouteParameterBinderInterface.php
    ├── HttpRouteSymbolInterface.php
    ├── InotifyIterator.php
    ├── InputValidatedData.php
    ├── InputValidatedData
    │   ├── FrontMatter.php
    │   └── JsonRPCMessage.php
    ├── InputValidationResult.php
    ├── InputValidator.php
    ├── InputValidator
    │   ├── FrontMatterValidator.php
    │   └── JsonRPCMessageValidator.php
    ├── InputValidatorCollection.php
    ├── InputValidatorController.php
    ├── InternalLinkBuilder.php
    ├── InternalRedirect.php
    ├── IntlDateFormatterRepository.php
    ├── IntlFormatter.php
    ├── JsonErrorTemplate.php
    ├── JsonErrorTemplateInterface.php
    ├── JsonRPCMethodInterface.php
    ├── JsonRPCMethodValidatorInterface.php
    ├── JsonRPCNotification.php
    ├── JsonRPCNotificationError.php
    ├── JsonRPCRequest.php
    ├── JsonRPCResponse.php
    ├── JsonRPCResponseError.php
    ├── JsonSchemableInterface.php
    ├── JsonSerializer.php
    ├── JsonTemplate.php
    ├── LlamaCppClient.php
    ├── LlamaCppClientInterface.php
    ├── LlamaCppClientResponseChunk.php
    ├── LlamaCppClientTest.php
    ├── LlamaCppCompletionIterator.php
    ├── LlamaCppCompletionRequest.php
    ├── LlamaCppCompletionToken.php
    ├── LlamaCppConfiguration.php
    ├── LlamaCppEmbedding.php
    ├── LlamaCppEmbeddingRequest.php
    ├── LlamaCppExtractSubject.php
    ├── LlamaCppExtractSubjectInterface.php
    ├── LlamaCppExtractSubjectResult.php
    ├── LlamaCppExtractSubjectTest.php
    ├── LlamaCppExtractWhen.php
    ├── LlamaCppExtractWhenInterface.php
    ├── LlamaCppExtractWhenResult.php
    ├── LlamaCppExtractWhenTest.php
    ├── LlamaCppExtractYesNoMaybe.php
    ├── LlamaCppExtractYesNoMaybeResult.php
    ├── LlamaCppExtractYesNoMaybeTest.php
    ├── LlamaCppHealthStatus.php
    ├── LlamaCppInfill.php
    ├── LlamaCppInfillRequest.php
    ├── LlamaCppLinkBuilder.php
    ├── LlmChatHistory.php
    ├── LlmChatHistoryRenderer.php
    ├── LlmChatMessage.php
    ├── LlmChatMessageRenderer.php
    ├── LlmChatMessageRenderer
    │   ├── ChatMLMessageRenderer.php
    │   ├── ChatMLMessageRendererTest.php
    │   ├── GemmaInstructMessageRenderer.php
    │   ├── MistralInstructMessageRenderer.php
    │   └── Phi2QuestionRenderer.php
    ├── LlmChatMessageRendererInterface.php
    ├── LlmChatTemplateType.php
    ├── LlmCompletionProgress.php
    ├── LlmCompletionProgressInterface.php
    ├── LlmCompletionTokenInterface.php
    ├── LlmPersona.php
    ├── LlmPersona
    │   └── HelpfulAssistant.php
    ├── LlmPersonaInterface.php
    ├── LlmPrompt.php
    ├── LlmPrompt
    │   └── SubjectActionPrompt.php
    ├── LoggableInterface.php
    ├── MailBounceReportInterface.php
    ├── Mailer.php
    ├── MailerConfiguration.php
    ├── MailerRepository.php
    ├── MailerTransportConfiguration.php
    ├── MarkdownParser.php
    ├── NameableEnumTrait.php
    ├── NameableInterface.php
    ├── OAuth2AccessTokenRepository.php
    ├── OAuth2AuthCodeRepository.php
    ├── OAuth2AuthorizationCodeFlowController.php
    ├── OAuth2AuthorizationCodeFlowControllerInterface.php
    ├── OAuth2AuthorizationRequestSessionStore.php
    ├── OAuth2AuthorizedUser.php
    ├── OAuth2Claim.php
    ├── OAuth2ClaimReader.php
    ├── OAuth2ClientRepository.php
    ├── OAuth2Configuration.php
    ├── OAuth2Endpoint.php
    ├── OAuth2EndpointResponderAggregate.php
    ├── OAuth2Entity.php
    ├── OAuth2Entity
    │   ├── Client.php
    │   ├── RefreshToken.php
    │   ├── Scope.php
    │   ├── Token.php
    │   ├── Token
    │   │   ├── AccessToken.php
    │   │   └── AuthCode.php
    │   └── User.php
    ├── OAuth2EntityRepositoryInterface.php
    ├── OAuth2Grant.php
    ├── OAuth2GrantAwareClient.php
    ├── OAuth2GrantCollection.php
    ├── OAuth2GrantProvider.php
    ├── OAuth2GrantProviderInterface.php
    ├── OAuth2RefreshTokenRepository.php
    ├── OAuth2Scope.php
    ├── OAuth2ScopeCollection.php
    ├── OAuth2ScopeInterface.php
    ├── OAuth2ScopePattern.php
    ├── OAuth2ScopePatternChunk.php
    ├── OAuth2ScopePatternChunkTest.php
    ├── OAuth2ScopePatternMatch.php
    ├── OAuth2ScopePatternTest.php
    ├── OAuth2ScopeRepository.php
    ├── OAuth2SecretAwareClient.php
    ├── OAuth2UserSessionAuthenticated.php
    ├── ObjectType
    │   └── RootFieldType.php
    ├── ObservableTask.php
    ├── ObservableTaskCategory.php
    ├── ObservableTaskConfiguration.php
    ├── ObservableTaskInterface.php
    ├── ObservableTaskSlotStatusUpdate.php
    ├── ObservableTaskStatus.php
    ├── ObservableTaskStatusReporter.php
    ├── ObservableTaskStatusUpdate.php
    ├── ObservableTaskTable.php
    ├── ObservableTaskTableRow.php
    ├── ObservableTaskTableTest.php
    ├── PDOException.php
    ├── PHPFileIterator.php
    ├── PHPFileNamespaceReader.php
    ├── PHPFileReflectionClassAttribute.php
    ├── PHPFileReflectionClassAttributeIterator.php
    ├── PHPFileReflectionClassIterator.php
    ├── PHPFileReflectionFunctionAttribute.php
    ├── PHPFileReflectionFunctionAttributeIterator.php
    ├── PHPFileReflectionFunctionIterator.php
    ├── PHPFileTokenIterator.php
    ├── PHPProjectFiles.php
    ├── PHPTokenSequenceMatcher.php
    ├── PostfixBounceAnalyzer.php
    ├── PostfixBounceAnalyzerTest.php
    ├── PostfixBounceReport.php
    ├── PromptSubjectRequest.php
    ├── PromptSubjectResponderAggregate.php
    ├── PromptSubjectResponderCollection.php
    ├── PromptSubjectResponderInterface.php
    ├── PromptSubjectResponse.php
    ├── PromptSubjectResponseChunk.php
    ├── PsrMessage.php
    ├── PsrMessage
    │   ├── SwooleServerRequest.php
    │   └── SwooleServerResponse.php
    ├── PsrStringStream.php
    ├── PsrSwooleResponder.php
    ├── RedisConfiguration.php
    ├── RedisConnection.php
    ├── RedisConnectionPoolConfiguration.php
    ├── RedisConnectionPoolRepository.php
    ├── ReflectionAttributeInterface.php
    ├── ReflectionAttributeManager.php
    ├── RegisterableInterface.php
    ├── RequestDataSource.php
    ├── RequestMethod.php
    ├── RespondsToHttpAttributeClassCollection.php
    ├── RespondsToHttpAttributeRoute.php
    ├── RespondsToPromptSubjectAttributeCollection.php
    ├── RubixMLBackend
    │   └── Swoole.php
    ├── SQLiteVSSConfiguration.php
    ├── SQLiteVSSConnectionBuilder.php
    ├── SanitizedMarkdownParser.php
    ├── SecureIdentifierGenerator.php
    ├── SecurityPolicyHeaders.php
    ├── Serializer.php
    ├── Serializer
    │   ├── Igbinary.php
    │   └── Vanilla.php
    ├── SerializerInterface.php
    ├── ServerPipeMessage.php
    ├── ServerPipeMessage
    │   └── CloseWebSocketConnection.php
    ├── ServerPipeMessageDispatcher.php
    ├── ServerPipeMessageHandlerCollection.php
    ├── ServerPipeMessageHandlerInterface.php
    ├── ServerPipeMessageInterface.php
    ├── ServerTask.php
    ├── ServerTask
    │   └── SendEmailMessage.php
    ├── ServerTaskHandler.php
    ├── ServerTaskHandler
    │   └── SendsEmailMessage.php
    ├── ServerTaskHandlerCollection.php
    ├── ServerTaskHandlerDispatcher.php
    ├── ServerTaskHandlerInterface.php
    ├── Session.php
    ├── SessionAuthentication.php
    ├── SessionConfiguration.php
    ├── SessionManager.php
    ├── SideEffectProvider.php
    ├── SideEffectProvider
    │   ├── RegisterDoctrineJsonDocumentType.php
    │   └── RegisterDoctrineUlidType.php
    ├── SideEffectProviderInterface.php
    ├── SingletonAttribute.php
    ├── SingletonAttributeClassFilterInterator.php
    ├── SingletonCollection.php
    ├── SingletonCollectionInterface.php
    ├── SingletonContainer.php
    ├── SingletonContainerAttributeIterator.php
    ├── SingletonContainerException.php
    ├── SingletonContainerException
    │   └── NotFoundException.php
    ├── SingletonContainerInterface.php
    ├── SingletonContainerTest.php
    ├── SingletonFunctionParameter.php
    ├── SingletonFunctionParametersIterator.php
    ├── SingletonProvider.php
    ├── SingletonProvider
    │   ├── AuthenticatedUserStoreAggregateProvider.php
    │   ├── ConfigurationFileProvider.php
    │   ├── ConfigurationProvider.php
    │   ├── ConfigurationProvider
    │   │   ├── ApplicationConfigurationProvider.php
    │   │   ├── DatabaseConfigurationProvider.php
    │   │   ├── GrpcConfigurationProvider.php
    │   │   ├── LlamaCppConfigurationProvider.php
    │   │   ├── MailerConfigurationProvider.php
    │   │   ├── OAuth2ConfigurationProvider.php
    │   │   ├── ObservableTaskConfigurationProvider.php
    │   │   ├── RedisConfigurationProvider.php
    │   │   ├── SQLiteVSSConfigurationProvider.php
    │   │   ├── SessionConfigurationProvider.php
    │   │   ├── StaticPageConfigurationProvider.php
    │   │   ├── SwooleConfigurationProvider.php
    │   │   ├── TranslatorConfigurationProvider.php
    │   │   └── WebSocketConfigurationProvider.php
    │   ├── ConsoleApplicationProvider.php
    │   ├── ConsoleOutputProvider.php
    │   ├── CronJobAggregateProvider.php
    │   ├── CrudActionGateAggregateProvider.php
    │   ├── DatabaseConnectionPoolRepositoryProvider.php
    │   ├── DoctrineAttributeDriverProvider.php
    │   ├── DoctrineDBALConfigurationProvider.php
    │   ├── DoctrineEntityListenerCollectionProvider.php
    │   ├── DoctrineEntityListenerResolverProvider.php
    │   ├── DoctrineEntityManagerRepositoryProvider.php
    │   ├── DoctrineEventManagerProvider.php
    │   ├── DoctrineORMConfigurationProvider.php
    │   ├── EventListenerAggregateProvider.php
    │   ├── FilesystemProvider.php
    │   ├── GraphQLSchemaProvider.php
    │   ├── HTMLPurifierProvider.php
    │   ├── HttpClientProvider.php
    │   ├── HttpControllerParameterResolverAggregateProvider.php
    │   ├── HttpInterceptorAggregateProvider.php
    │   ├── HttpMiddlewareAggregateProvider.php
    │   ├── HttpResponderCollectionProvider.php
    │   ├── HttpRouteParameterBinderAggregateProvider.php
    │   ├── HyperfChannelPool.php
    │   ├── InputValidatorCollectionProvider.php
    │   ├── InputValidatorControllerProvider.php
    │   ├── LlmChatMessageRendererProvider.php
    │   ├── MailerRepositoryProvider.php
    │   ├── NettePrinterProvider.php
    │   ├── NetteSchemaProcessorProvider.php
    │   ├── OAuth2AuthorizationServerProvider.php
    │   ├── OAuth2EndpointResponderAggregateProvider.php
    │   ├── OAuth2GrantCollectionProvider.php
    │   ├── OAuth2ResourceServerProvider.php
    │   ├── OAuth2ScopeCollectionProvider.php
    │   ├── PromptSubjectResponderCollectionProvider.php
    │   ├── RedisConnectionPoolRepositoryProvider.php
    │   ├── RequestContextProvider.php
    │   ├── RespondsToHttpAttributeClassCollectionProvider.php
    │   ├── RespondsToPromptSubjectAttributeCollectionProvider.php
    │   ├── SerializerProvider.php
    │   ├── ServerPipeMessageHandlerCollectionProvider.php
    │   ├── ServerTaskHandlerCollectionProvider.php
    │   ├── SiteActionGateAggregateProvider.php
    │   ├── StaticPageAggregateProvider.php
    │   ├── StaticPageCollectionAggregateProvider.php
    │   ├── StaticPageLayoutAggregateProvider.php
    │   ├── TickTimerJobAggregateProvider.php
    │   ├── TranslatorBridgeProvider.php
    │   ├── TwigChainLoaderProvider.php
    │   ├── TwigEnvironmentProvider.php
    │   ├── TwigFilterCollectionProvider.php
    │   ├── TwigFunctionCollectionProvider.php
    │   ├── UrlGeneratorProvider.php
    │   ├── UrlMatcherProvider.php
    │   ├── WebSocketJsonRPCResponderAggregateProvider.php
    │   └── WebSocketProtocolControllerAggregateProvider.php
    ├── SingletonProviderInterface.php
    ├── SiteAction.php
    ├── SiteActionGate.php
    ├── SiteActionGateAggregate.php
    ├── SiteActionInterface.php
    ├── StaticPage.php
    ├── StaticPageAggregate.php
    ├── StaticPageChunkIterator.php
    ├── StaticPageCollection.php
    ├── StaticPageCollectionAggregate.php
    ├── StaticPageConfiguration.php
    ├── StaticPageContentRenderer.php
    ├── StaticPageContentType.php
    ├── StaticPageFileException.php
    ├── StaticPageFileException
    │   ├── DuplicateCollectionReferenceException.php
    │   └── FrontMatterValidationException.php
    ├── StaticPageFileIterator.php
    ├── StaticPageForestGenerator.php
    ├── StaticPageInternalLinkDelimiterProcessor.php
    ├── StaticPageInternalLinkMarkdownExtension.php
    ├── StaticPageInternalLinkNode.php
    ├── StaticPageInternalLinkNodeRenderer.php
    ├── StaticPageIterator.php
    ├── StaticPageLayoutAggregate.php
    ├── StaticPageLayoutInterface.php
    ├── StaticPageMarkdownParser.php
    ├── StaticPageParentIterator.php
    ├── StaticPageProcessor.php
    ├── StaticPageReferenceException.php
    ├── StaticPageRenderingException.php
    ├── StaticPageSitemapGenerator.php
    ├── SubjectActionTokenReader.php
    ├── SubjectActionTokenReaderTest.php
    ├── SwooleChannelIterator.php
    ├── SwooleChannelIteratorChunk.php
    ├── SwooleChannelIteratorError.php
    ├── SwooleConfiguration.php
    ├── SwooleContextRequestResponseReader.php
    ├── SwooleLoggerBridge.php
    ├── SwooleServer.php
    ├── SwooleServerRequestServer.php
    ├── SwooleServerRequestUri.php
    ├── SwooleTableAvailableRowsPool.php
    ├── SwooleTableAvailableRowsPoolTest.php
    ├── SwooleTaskServerMessageBroker.php
    ├── SwooleTaskServerMessageBus.php
    ├── SwooleTimeout.php
    ├── SwooleTimeoutScheduled.php
    ├── SwooleTimeoutTest.php
    ├── Template.php
    ├── TemplateComponentInterface.php
    ├── TemplateFilters.php
    ├── TemplateInterface.php
    ├── TestsDependencyInectionContainerTrait.php
    ├── TestsGraphQLQueriesTrait.php
    ├── TickTimerJobAggregate.php
    ├── TickTimerJobInterface.php
    ├── TickTimerRegisteredJob.php
    ├── TickTimerScheduler.php
    ├── TranslationException.php
    ├── TranslationException
    │   ├── LanguageNotFoundException.php
    │   ├── MissingTranslationParameterException.php
    │   └── PhraseNotFoundException.php
    ├── TranslationsLoader.php
    ├── TranslatorBridge.php
    ├── TranslatorConfiguration.php
    ├── TwigApplicationFilesystemLoader.php
    ├── TwigBridgeExtension.php
    ├── TwigChainLoader.php
    ├── TwigEsbuildContext.php
    ├── TwigFilter.php
    ├── TwigFilter
    │   ├── IntlFormatDate.php
    │   └── Trans.php
    ├── TwigFilterCollection.php
    ├── TwigFilterInterface.php
    ├── TwigFunction.php
    ├── TwigFunction
    │   ├── CSPInclude.php
    │   ├── CSPNonce.php
    │   ├── CSRFToken.php
    │   ├── Esbuild.php
    │   ├── EsbuildPreload.php
    │   ├── EsbuildRenderPreloads.php
    │   ├── GatekeeperCan.php
    │   ├── GatekeeperCanCrud.php
    │   ├── Old.php
    │   └── Route.php
    ├── TwigFunctionCollection.php
    ├── TwigFunctionInterface.php
    ├── TwigOptionalLoaderInterface.php
    ├── TwigResonanceFilesystemLoader.php
    ├── TwigTemplate.php
    ├── UserInterface.php
    ├── UserRepositoryInterface.php
    ├── UserRoleInterface.php
    ├── WebSocketAuthResolution.php
    ├── WebSocketConfiguration.php
    ├── WebSocketConnection.php
    ├── WebSocketConnectionStatus.php
    ├── WebSocketJsonRPCConnectionController.php
    ├── WebSocketJsonRPCConnectionControllerInterface.php
    ├── WebSocketJsonRPCConnectionHandle.php
    ├── WebSocketJsonRPCResponder.php
    ├── WebSocketJsonRPCResponder
    │   └── LlamaCppSubjectActionPromptResponder.php
    ├── WebSocketJsonRPCResponderAggregate.php
    ├── WebSocketJsonRPCResponderInterface.php
    ├── WebSocketProtocol.php
    ├── WebSocketProtocolController.php
    ├── WebSocketProtocolController
    │   └── JsonRPCProtocolController.php
    ├── WebSocketProtocolControllerAggregate.php
    ├── WebSocketProtocolControllerInterface.php
    ├── WebSocketProtocolException.php
    ├── WebSocketProtocolException
    │   ├── UnexpectedNotification.php
    │   └── UnexpectedRequest.php
    ├── WebSocketProtocolIterator.php
    ├── WebSocketProtocolIteratorTest.php
    ├── WebSocketResolvedProtocolController.php
    ├── WebSocketServerConnectionTable.php
    ├── WebSocketServerController.php
    ├── YesNo.php
    ├── YesNoMaybe.php
    └── helpers
    │   ├── coroutineMustGetContext.php
    │   ├── coroutineMustGo.php
    │   ├── coroutineMustRun.php
    │   └── generatorGetReturn.php
├── tmuxinator.example.yml
├── tools
    ├── php-cs-fixer
    │   ├── .gitignore
    │   ├── Makefile
    │   ├── composer.json
    │   └── composer.lock
    └── psalm
    │   ├── .gitignore
    │   ├── Makefile
    │   ├── composer.json
    │   └── composer.lock
├── tsconfig.json
└── yarn.lock


/.gitignore:
--------------------------------------------------------------------------------
1 | *~
2 | /*.cache
3 | /.pnp.*
4 | /.yarn
5 | /config.ini
6 | /esbuild-meta-docs.json
7 | /node_modules
8 | /sqlite-vss
9 | /vendor


--------------------------------------------------------------------------------
/app/README.md:
--------------------------------------------------------------------------------
1 | # App
2 | 
3 | This folder contains templates used to generate the 
4 | [documentation](https://resonance.distantmagic.com/).
5 | 
6 | For the framework itself, check the `src/` folder.
7 | 


--------------------------------------------------------------------------------
/app/Template/Component.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Docs\Template;
 6 | 
 7 | use Distantmagic\Resonance\Template;
 8 | use Distantmagic\Resonance\TemplateComponentInterface;
 9 | 
10 | abstract readonly class Component extends Template implements TemplateComponentInterface {}
11 | 


--------------------------------------------------------------------------------
/app/Template/StaticPageLayout.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Docs\Template;
 6 | 
 7 | use Distantmagic\Resonance\StaticPageLayoutInterface;
 8 | use Distantmagic\Resonance\Template;
 9 | 
10 | abstract readonly class StaticPageLayout extends Template implements StaticPageLayoutInterface {}
11 | 


--------------------------------------------------------------------------------
/bin/resonance.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | use Distantmagic\Resonance\ConsoleApplication;
 6 | 
 7 | $container = require_once __DIR__.'/../container.php';
 8 | 
 9 | exit($container->make(ConsoleApplication::class)->run());
10 | 


--------------------------------------------------------------------------------
/constants.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | define('DM_APP_ROOT', __DIR__.'/app');
 6 | define('DM_BATCH_PROMISE_TIMEOUT', 0.3);
 7 | define('DM_GRAPHQL_PROMISE_TIMEOUT', 0.2);
 8 | define('DM_POOL_CONNECTION_TIMEOUT', 0.1);
 9 | define('DM_PUBLIC_ROOT', __DIR__.'/public');
10 | define('DM_RESONANCE_ROOT', __DIR__.'/src');
11 | define('DM_ROOT', __DIR__);
12 | 


--------------------------------------------------------------------------------
/container.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | require_once __DIR__.'/vendor/autoload.php';
 6 | require_once __DIR__.'/constants.php';
 7 | 
 8 | defined('DM_ROOT') or exit('Configuration is not loaded.');
 9 | 
10 | use Distantmagic\Resonance\DependencyInjectionContainer;
11 | use Swoole\Runtime;
12 | 
13 | Runtime::enableCoroutine(SWOOLE_HOOK_ALL);
14 | 
15 | $container = new DependencyInjectionContainer();
16 | $container->phpProjectFiles->indexDirectory(DM_RESONANCE_ROOT);
17 | $container->phpProjectFiles->indexDirectory(DM_APP_ROOT);
18 | $container->registerSingletons();
19 | 
20 | return $container;
21 | 


--------------------------------------------------------------------------------
/docs/.gitignore:
--------------------------------------------------------------------------------
1 | /artifact.tar
2 | /build
3 | /public
4 | 


--------------------------------------------------------------------------------
/docs/.nojekyll:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/docs/.nojekyll


--------------------------------------------------------------------------------
/docs/CNAME:
--------------------------------------------------------------------------------
1 | resonance.distantmagic.com
2 | 


--------------------------------------------------------------------------------
/docs/pages/community/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 |     - primary_navigation
 5 | layout: dm:tutorial-list
 6 | title: Community
 7 | description: >
 8 |     Join our community channels to stay informed about new Resonance 
 9 |     developments and features.
10 | ---
11 | 
12 | # Community
13 | 
14 | Feel free to use [GitHub discussions](https://github.com/distantmagic/resonance/discussions) and other pages related to the repository.
15 | 


--------------------------------------------------------------------------------
/docs/pages/docs/extras/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/index
 6 | title: Extras
 7 | description: >
 8 |     Read additional information that might be useful but is not directly 
 9 |     related to the framework.
10 | ---
11 | 
12 | # Extras
13 | 
14 | {{docs/extras/*/index}}
15 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/ai/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: Artificial Intelligence
 7 | description: >
 8 |     Use integration features to serve or use AI models.
 9 | ---
10 | 
11 | # Artificial Intelligence
12 | 
13 | {{docs/features/ai/*/index}}
14 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/ai/prompt-templates/gemma/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/ai/prompt-templates/index
 6 | title: Gemma
 7 | description: >
 8 |     Google's Open-Source alternative to Gemini.
 9 | ---
10 | 
11 | # Gemma
12 | 
13 | Those templates are prepared based on the 
14 | [Huggingsface blog release](https://huggingface.co/blog/gemma#prompt-format).
15 | 
16 | # Usage
17 | 
18 | ## Chat Format
19 | 
20 | ```
21 | <start_of_turn>user
22 | knock knock<end_of_turn>
23 | ```
24 | 
25 | ```php
26 | <?php
27 | 
28 | namespace App;
29 | 
30 | use Distantmagic\Resonance\LlmPromptTemplate\GemmaInstructChat;
31 | 
32 | $template = new GemmaInstructChat('user', 'How to make a cat happy?');
33 | ```
34 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/ai/prompt-templates/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/ai/index
 6 | title: Prompt Templates
 7 | description: >
 8 |     Match prompt template with the LLM you are using for the best results.
 9 | ---
10 | 
11 | # Prompt Templates
12 | 
13 | Although Large Language Models and Small Language Models strive to be able to
14 | respond to any user prompt, they still require some dose of engineering in 
15 | order to get desired results.
16 | 
17 | Resonance includes prompt templates for common tasks and the most popular 
18 | models.
19 | 
20 | Contributions here are more than welcome.
21 | 
22 | {{docs/features/ai/prompt-templates/*/index}}
23 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/ai/server/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/ai/index
 6 | title: Server
 7 | description: >
 8 |     Use Resonance to connect various language models.
 9 | ---
10 | 
11 | # Server
12 | 
13 | {{docs/features/ai/server/*/index}}
14 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/conversational-applications/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: Conversational Applications
 7 | description: >
 8 |     Build and maintain copilots, scripted dialogues, semi-scripted
 9 |     dialogues and fully conversational applications.
10 | ---
11 | 
12 | # Conversational Applications
13 | 
14 | You can build and maintain copilots, scripted dialogues, 
15 | semi-scripted dialogues and fully conversational applications.
16 | 
17 | {{docs/features/conversational-applications/*/index}}
18 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/database/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: SQL Database
 7 | description: >
 8 |     Learn how Resonance uses connection pools. Create and reuse queries, 
 9 |     create database entities, and integrate with a migration tool.
10 | ---
11 | 
12 | # SQL Database
13 | 
14 | {{docs/features/database/*/index}}
15 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/database/swoole/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - name: documents
 4 |       next: docs/features/database/doctrine/index
 5 | layout: dm:document
 6 | parent: docs/features/database/index
 7 | title: Swoole
 8 | description: >
 9 |     Use Resonance's wrapper around Swoole connection pools.
10 | ---
11 | 
12 | # Swoole
13 | 
14 | {{docs/features/database/swoole/*!docs/features/database/swoole/index}}
15 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/graphql/merging-sql-queries.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | description: test
 5 | draft: true
 6 | layout: dm:document
 7 | parent: docs/features/graphql/index
 8 | title: Merging SQL Queries
 9 | ---
10 | 
11 | # Merging SQL Queries
12 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/http/server.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/http/index
 6 | title: Server
 7 | description: >
 8 |     Configure the Resonance "serve" command and start the http server.
 9 | ---
10 | 
11 | # HTTP Server
12 | 
13 | # Usage
14 | 
15 | Resonance comes with the `serve` command by default. You can call
16 | `php ./bin/resonance.php serve` to start the http server.
17 | 
18 | You can configure it using the {{docs/features/configuration/index}} file.
19 | If you want to add {{docs/features/websockets/index}}, you can follow their 
20 | configuration page.
21 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - name: documents
 4 |       next: docs/extras/index
 5 | layout: dm:document
 6 | parent: docs/index
 7 | title: Features
 8 | description: >
 9 |     Learn about the functionalities provided by the Resonance framework.
10 | ---
11 | 
12 | # Features
13 | 
14 | {{docs/features/*/index}}
15 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/observability/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: Observability
 7 | description: >
 8 |     Observability is the ability to understand the state of a running system.
 9 | ---
10 | 
11 | # Observability
12 | 
13 | {{docs/features/observability/*/index}}
14 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/server-side-rendering/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | description: test
 5 | draft: true
 6 | layout: dm:document
 7 | parent: docs/features/index
 8 | title: Server Side Rendering
 9 | ---
10 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/templating/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: Templating
 7 | description: >
 8 |     Learn how to utilize Twig or write your own PHP templates.
 9 | ---
10 | 
11 | # Templating
12 | 
13 | {{docs/features/templating/*/index}}
14 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/templating/twig/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/templating/index
 6 | title: Twig
 7 | description: >
 8 |     Learn how the the Twig environment is integrated within the Resonance 
 9 |     framework.
10 | ---
11 | 
12 | # Twig
13 | 
14 | [Twig](https://twig.symfony.com/) is "the flexible, fast, and secure template 
15 | engine for PHP." It's bundled with Resonance alongside a few useful extensions
16 | that integrate the Twig environment with the framework.
17 | 
18 | {{docs/features/templating/twig/*!docs/features/templating/twig/index}}
19 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/timers/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: Timers
 7 | description: >
 8 |     Learn how to schedule cyclical tasks.
 9 | ---
10 | 
11 | # Timers
12 | 
13 | {{docs/features/timers/*/index}}
14 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/validation/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: Validation
 7 | description: >
 8 |     Validate and convert any data. Learn how to validate HTML forms, incoming
 9 |     WebSocket messages and more.
10 | ---
11 | 
12 | # Validation
13 | 
14 | You can use validators to check if any incoming data is correct. For example:
15 | form data filled by the user, incoming {{docs/features/websockets/index}} 
16 | message, and others.
17 | 
18 | {{docs/features/validation/*/index}}
19 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/vector-store/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: Vector Store
 7 | description: >
 8 |     Vector stores can be used to store and search large vectors, such as LLM
 9 |     embeddings.
10 | ---
11 | 
12 | # Vector Store
13 | 
14 | Explore Resonance's integrations with vector stores.
15 | 
16 | {{docs/features/vector-store/*/index}}
17 | 


--------------------------------------------------------------------------------
/docs/pages/docs/features/websockets/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 | layout: dm:document
 5 | parent: docs/features/index
 6 | title: WebSockets
 7 | description: >
 8 |     Start and use the WebSockets server.
 9 | ---
10 | 
11 | # WebSockets
12 | 
13 | {{docs/features/websockets/*!docs/features/websockets/index}}
14 | 


--------------------------------------------------------------------------------
/docs/pages/docs/getting-started/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - name: documents
 4 |       next: docs/changelog/index
 5 | layout: dm:document
 6 | parent: docs/index
 7 | title: Getting Started
 8 | description: >
 9 |     Learn about the installation, requirements and framework's long-term
10 |     goals.
11 | ---
12 | 
13 | # Getting Started
14 | 
15 | {{docs/getting-started/*!docs/getting-started/index}}
16 | 


--------------------------------------------------------------------------------
/docs/pages/docs/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - documents
 4 |     - name: primary_navigation
 5 |       next: tutorials/index
 6 | description: docs
 7 | layout: dm:document
 8 | title: Documentation
 9 | ---
10 | 
11 | # Documentation
12 | 
13 | {{docs/*/index}}
14 | 


--------------------------------------------------------------------------------
/docs/pages/swoole/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - primary_navigation
 4 | description: test
 5 | draft: true
 6 | layout: dm:page
 7 | title: Swoole
 8 | ---
 9 | 
10 | # Swoole
11 | 


--------------------------------------------------------------------------------
/docs/pages/tutorials/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections: 
 3 |     - name: primary_navigation
 4 |       next: use-cases/index
 5 | description: docs
 6 | layout: dm:tutorial-list
 7 | title: Tutorials
 8 | ---
 9 | 
10 | # Tutorials
11 | 
12 | If you want to suggest a tutorial, feel free to open an issue in the 
13 | [GitHub](https://github.com/distantmagic/resonance) repo.
14 | 
15 | More tutorials and recipes are coming. Join our {{community/index}} to receive
16 | notifications.
17 | 
18 | {{tutorials/*/index}}
19 | 


--------------------------------------------------------------------------------
/docs/pages/tutorials/oauth2-server/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections:
 3 |   - tutorials
 4 | draft: true
 5 | layout: dm:tutorial
 6 | parent: tutorials/index
 7 | tags:
 8 |     - OAuth2
 9 | title: OAuth 2.0 Server
10 | description: >
11 |     Learn how to setup an OAuth 2.0 server with Resonance and Doctrine.
12 | ---
13 | 


--------------------------------------------------------------------------------
/docs/pages/tutorials/retrieval-augmented-generation-with-resonance-and-rubixml/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | collections:
 3 |   - tutorials
 4 | draft: true
 5 | layout: dm:tutorial
 6 | parent: tutorials/index
 7 | tags: 
 8 |   - llama.cpp
 9 |   - RubixML
10 |   - Static Site Generator
11 | title: Semantic Search with Resonance and RubixML
12 | description: >
13 |     Learn how to implement a semantic search using KNN search.
14 | ---
15 | 
16 | ## Overview
17 | 
18 | To achieve the semantic search index, we will go through the following steps:
19 | 1. Prepare the training data (cleaning up, chunking)
20 | 


--------------------------------------------------------------------------------
/examples/machine-learning/.gitignore:
--------------------------------------------------------------------------------
1 | /cache
2 | /config.ini
3 | /oauth2
4 | /repository
5 | /ssl
6 | /vendor
7 | 


--------------------------------------------------------------------------------
/examples/machine-learning/README.md:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/examples/machine-learning/README.md


--------------------------------------------------------------------------------
/examples/machine-learning/app/UserRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\UserInterface;
 9 | use Distantmagic\Resonance\UserRepositoryInterface;
10 | 
11 | #[Singleton(provides: UserRepositoryInterface::class)]
12 | readonly class UserRepository implements UserRepositoryInterface
13 | {
14 |     public function findUserById(int|string $userId): ?UserInterface
15 |     {
16 |         return null;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/examples/machine-learning/app/lang/en/error.ini:
--------------------------------------------------------------------------------
1 | bad_request = "Bad request"
2 | forbidden = Forbidden
3 | method_not_allowed = "Method not allowed"
4 | not_acceptable = "Not acceptable"
5 | page_not_found = "Page not found"
6 | server_error = "Server error"
7 | 


--------------------------------------------------------------------------------
/examples/machine-learning/app/views/error.twig:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html>
 3 | <head>
 4 |     <meta charset="utf-8">
 5 |     <meta name="viewport" content="width=device-width, initial-scale=1">
 6 |     <title></title>
 7 | </head>
 8 | <body>
 9 |     <h1>{{ error.code }}</h1>
10 |     <pre>{{ error.message(request) }}</pre>
11 | </body>
12 | </html>


--------------------------------------------------------------------------------
/examples/machine-learning/app/views/homepage.twig:
--------------------------------------------------------------------------------
1 | Hello, world!
2 | 


--------------------------------------------------------------------------------
/examples/machine-learning/bin/doctrine.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | use Distantmagic\Resonance\DoctrineConsoleRunner;
 6 | 
 7 | $container = require_once __DIR__.'/../container.php';
 8 | 
 9 | exit(DoctrineConsoleRunner::run($container));
10 | 


--------------------------------------------------------------------------------
/examples/machine-learning/bin/resonance.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | use Distantmagic\Resonance\ConsoleApplication;
 6 | 
 7 | $container = require_once __DIR__.'/../container.php';
 8 | 
 9 | exit($container->make(ConsoleApplication::class)->run());
10 | 


--------------------------------------------------------------------------------
/examples/machine-learning/constants.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | define('DM_APP_ROOT', __DIR__.'/app');
 6 | define('DM_BATCH_PROMISE_TIMEOUT', 0.3);
 7 | define('DM_GRAPHQL_PROMISE_TIMEOUT', 0.2);
 8 | define('DM_POOL_CONNECTION_TIMEOUT', 0.1);
 9 | define('DM_PUBLIC_ROOT', __DIR__.'/public');
10 | define('DM_RESONANCE_ROOT', __DIR__.'/vendor/distantmagic/resonance/src');
11 | define('DM_ROOT', __DIR__);
12 | 


--------------------------------------------------------------------------------
/examples/machine-learning/container.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | require_once __DIR__.'/vendor/autoload.php';
 6 | 
 7 | defined('DM_ROOT') or exit('Configuration is not loaded.');
 8 | 
 9 | use Distantmagic\Resonance\DependencyInjectionContainer;
10 | use Swoole\Runtime;
11 | 
12 | Runtime::enableCoroutine(SWOOLE_HOOK_ALL);
13 | 
14 | $container = new DependencyInjectionContainer();
15 | $container->phpProjectFiles->indexDirectory(DM_RESONANCE_ROOT);
16 | $container->phpProjectFiles->indexDirectory(DM_APP_ROOT);
17 | $container->registerSingletons();
18 | 
19 | return $container;
20 | 


--------------------------------------------------------------------------------
/examples/machine-learning/models/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore


--------------------------------------------------------------------------------
/examples/machine-learning/tools/psalm/.gitignore:
--------------------------------------------------------------------------------
1 | /vendor
2 | 


--------------------------------------------------------------------------------
/examples/machine-learning/tools/psalm/composer.json:
--------------------------------------------------------------------------------
1 | {
2 |     "require": {
3 |         "vimeo/psalm": "^5.21"
4 |     }
5 | }
6 | 


--------------------------------------------------------------------------------
/phpunit_bootstrap.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | require_once __DIR__.'/vendor/autoload.php';
6 | require_once __DIR__.'/constants.php';
7 | 


--------------------------------------------------------------------------------
/resources/icons/circle-info-000000.svg:
--------------------------------------------------------------------------------
1 | <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
2 | <!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
3 | <path
4 |     d="M256 512A256 256 0 1 0 256 0a256 256 0 1 0 0 512zM216 336h24V272H216c-13.3 0-24-10.7-24-24s10.7-24 24-24h48c13.3 0 24 10.7 24 24v88h8c13.3 0 24 10.7 24 24s-10.7 24-24 24H216c-13.3 0-24-10.7-24-24s10.7-24 24-24zm40-208a32 32 0 1 1 0 64 32 32 0 1 1 0-64z"
5 |     fill="#000000"
6 | />
7 | </svg>
8 | 


--------------------------------------------------------------------------------
/resources/icons/info-000000.svg:
--------------------------------------------------------------------------------
1 | <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 512">
2 | <!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
3 | <path
4 |     d="M48 80a48 48 0 1 1 96 0A48 48 0 1 1 48 80zM0 224c0-17.7 14.3-32 32-32H96c17.7 0 32 14.3 32 32V448h32c17.7 0 32 14.3 32 32s-14.3 32-32 32H32c-17.7 0-32-14.3-32-32s14.3-32 32-32H64V256H32c-17.7 0-32-14.3-32-32z"
5 |     fill="#000000"
6 | />
7 | </svg>
8 | 


--------------------------------------------------------------------------------
/resources/icons/search-000000.svg:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <svg
 3 |     fill="#000000"
 4 |     version="1.1"
 5 |     xmlns="http://www.w3.org/2000/svg"
 6 |     xmlns:xlink="http://www.w3.org/1999/xlink"
 7 |     x="0px"
 8 |     y="0px"
 9 |     viewBox="0 0 64 64"
10 |     xml:space="preserve"
11 | >
12 |     <path d="M61.4,55.7L44.9,42.3c6.8-9.3,6.1-22.6-2.4-31c-4.5-4.5-10.5-7-16.9-7s-12.4,2.5-16.9,7c-9.3,9.3-9.3,24.5,0,33.8
13 |     c4.5,4.5,10.5,7,16.9,7c6.1,0,11.8-2.3,16.3-6.4l16.7,13.5c0.4,0.3,0.9,0.5,1.4,0.5c0.7,0,1.3-0.3,1.7-0.8
14 |     C62.5,57.9,62.4,56.5,61.4,55.7z M25.6,47.6c-5.2,0-10-2-13.7-5.7c-7.6-7.6-7.6-19.9,0-27.4c3.7-3.7,8.5-5.7,13.7-5.7
15 |     c5.2,0,10,2,13.7,5.7c7.6,7.6,7.6,19.9,0,27.4C35.7,45.6,30.8,47.6,25.6,47.6z" />
16 | </svg>
17 | 


--------------------------------------------------------------------------------
/resources/icons/triangle-exclamation-000000.svg:
--------------------------------------------------------------------------------
1 | <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
2 | <!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
3 | <path
4 |     d="M256 32c14.2 0 27.3 7.5 34.5 19.8l216 368c7.3 12.4 7.3 27.7 .2 40.1S486.3 480 472 480H40c-14.3 0-27.6-7.7-34.7-20.1s-7-27.8 .2-40.1l216-368C228.7 39.5 241.8 32 256 32zm0 128c-13.3 0-24 10.7-24 24V296c0 13.3 10.7 24 24 24s24-10.7 24-24V184c0-13.3-10.7-24-24-24zm32 224a32 32 0 1 0 -64 0 32 32 0 1 0 64 0z"
5 |     fill="#000000"
6 | />
7 | </svg>
8 | 


--------------------------------------------------------------------------------
/resources/icons/up-right-from-square-fbb829.svg:
--------------------------------------------------------------------------------
1 | <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
2 | <!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
3 | <path
4 |     d="M352 0c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9L370.7 96 201.4 265.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0L416 141.3l41.4 41.4c9.2 9.2 22.9 11.9 34.9 6.9s19.8-16.6 19.8-29.6V32c0-17.7-14.3-32-32-32H352zM80 32C35.8 32 0 67.8 0 112V432c0 44.2 35.8 80 80 80H400c44.2 0 80-35.8 80-80V320c0-17.7-14.3-32-32-32s-32 14.3-32 32V432c0 8.8-7.2 16-16 16H80c-8.8 0-16-7.2-16-16V112c0-8.8 7.2-16 16-16H192c17.7 0 32-14.3 32-32s-14.3-32-32-32H80z"
5 |     fill="#fbb829"
6 | />
7 | </svg>
8 | 


--------------------------------------------------------------------------------
/resources/images/amphp.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/amphp.webp


--------------------------------------------------------------------------------
/resources/images/chatgpt.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/chatgpt.webp


--------------------------------------------------------------------------------
/resources/images/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/favicon.ico


--------------------------------------------------------------------------------
/resources/images/ogimage.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/ogimage.webp


--------------------------------------------------------------------------------
/resources/images/openswoole.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/openswoole.png


--------------------------------------------------------------------------------
/resources/images/resonance_cat.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/resonance_cat.webp


--------------------------------------------------------------------------------
/resources/images/rubixml.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/rubixml.png


--------------------------------------------------------------------------------
/resources/images/swoole.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/swoole.png


--------------------------------------------------------------------------------
/resources/images/zork.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/distantmagic/resonance/8fa506ee4cb6977224375ce5c7a95f84cb627783/resources/images/zork.png


--------------------------------------------------------------------------------
/resources/ts/app/LoggerInterface.ts:
--------------------------------------------------------------------------------
 1 | type LoggingMethod = (...message: Array<unknown>) => void;
 2 | 
 3 | export interface LoggerInterface {
 4 |   debug: LoggingMethod;
 5 |   error: LoggingMethod;
 6 |   info: LoggingMethod;
 7 |   log: LoggingMethod;
 8 |   success: LoggingMethod;
 9 |   warn: LoggingMethod;
10 | 
11 |   ns(contextName: string): LoggerInterface;
12 | }
13 | 


--------------------------------------------------------------------------------
/resources/ts/app/createLogger.ts:
--------------------------------------------------------------------------------
1 | import { Logger } from "./Logger";
2 | 
3 | import type { LoggerInterface } from "./LoggerInterface";
4 | 
5 | export function createLogger(contextName: string): LoggerInterface {
6 |   return new Logger(contextName);
7 | }
8 | 


--------------------------------------------------------------------------------
/resources/ts/docs/controller_aside.ts:
--------------------------------------------------------------------------------
 1 | import { Controller } from "@hotwired/stimulus";
 2 | 
 3 | import { stimulus } from "../stimulus";
 4 | 
 5 | @stimulus("aside")
 6 | export class controller_aside extends Controller<HTMLElement> {
 7 |   public connect(): void {
 8 |     const activeLink = this.element.querySelector("a.active");
 9 | 
10 |     if (!(activeLink instanceof HTMLAnchorElement)) {
11 |       return;
12 |     }
13 | 
14 |     activeLink.scrollIntoView({
15 |       behavior: "auto",
16 |       block: "center",
17 |       inline: "center",
18 |     });
19 |   }
20 | }
21 | 


--------------------------------------------------------------------------------
/resources/ts/docs/global_stimulus.ts:
--------------------------------------------------------------------------------
1 | import { Application } from "@hotwired/stimulus";
2 | 
3 | window.stimulusApplication = Application.start();
4 | 


--------------------------------------------------------------------------------
/resources/ts/docs/global_turbo.ts:
--------------------------------------------------------------------------------
1 | import "@hotwired/turbo";
2 | 
3 | import { configureTurbo } from "../configureTurbo";
4 | 
5 | configureTurbo();
6 | 


--------------------------------------------------------------------------------
/src/ApplicationConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class ApplicationConfiguration
 8 | {
 9 |     /**
10 |      * @param non-empty-string $esbuildMetafile
11 |      * @param non-empty-string $scheme
12 |      * @param non-empty-string $url
13 |      */
14 |     public function __construct(
15 |         public Environment $environment,
16 |         public ?string $esbuildMetafile,
17 |         public string $scheme,
18 |         public string $url,
19 |     ) {}
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Attribute.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class Attribute {}
8 | 


--------------------------------------------------------------------------------
/src/Attribute/Can.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\SiteActionInterface;
10 | 
11 | #[Attribute(Attribute::IS_REPEATABLE | Attribute::TARGET_CLASS | Attribute::TARGET_FUNCTION)]
12 | final readonly class Can extends BaseAttribute
13 | {
14 |     public function __construct(public SiteActionInterface $siteAction) {}
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Attribute/ConsoleCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | readonly class ConsoleCommand extends BaseAttribute
12 | {
13 |     /**
14 |      * @param non-empty-string      $name
15 |      * @param array<string>         $aliases
16 |      * @param null|non-empty-string $description
17 |      */
18 |     public function __construct(
19 |         public string $name,
20 |         public array $aliases = [],
21 |         public ?string $description = null,
22 |         public bool $isEnabled = true,
23 |         public bool $isHidden = false,
24 |     ) {}
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Attribute/ContentSecurityPolicy.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\ContentSecurityPolicyType;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_FUNCTION)]
12 | final readonly class ContentSecurityPolicy extends BaseAttribute
13 | {
14 |     public function __construct(public ContentSecurityPolicyType $contentSecurityPolicyType) {}
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Attribute/ControlsWebSocketProtocol.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\WebSocketProtocol;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | readonly class ControlsWebSocketProtocol extends BaseAttribute
13 | {
14 |     public function __construct(
15 |         public WebSocketProtocol $webSocketProtocol,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/CrudActionSubject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class CrudActionSubject extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string $gate
15 |      */
16 |     public function __construct(public string $gate) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/CurrentRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_PARAMETER)]
11 | final readonly class CurrentRequest extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/CurrentResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_PARAMETER)]
11 | final readonly class CurrentResponse extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/DecidesCrudAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class DecidesCrudAction extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/DecidesSiteAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\SiteActionInterface;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | final readonly class DecidesSiteAction extends BaseAttribute
13 | {
14 |     public function __construct(public SiteActionInterface $siteAction) {}
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Attribute/DoctrineEntityManager.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_PARAMETER)]
11 | final readonly class DoctrineEntityManager extends BaseAttribute
12 | {
13 |     /**
14 |      * @param non-empty-string $connection
15 |      */
16 |     public function __construct(public string $connection = 'default') {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/DoctrineEntityRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_PARAMETER)]
11 | final readonly class DoctrineEntityRepository extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string     $entityClass
15 |      * @param non-empty-string $connection
16 |      */
17 |     public function __construct(
18 |         public string $entityClass,
19 |         public string $connection = 'default',
20 |     ) {}
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Attribute/ExtractsOpenAPIMetadataResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ExtractsOpenAPIMetadataResponse extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string<BaseAttribute> $fromAttribute
15 |      */
16 |     public function __construct(
17 |         public string $fromAttribute,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Attribute/ExtractsOpenAPIMetadataSecurityRequirement.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ExtractsOpenAPIMetadataSecurityRequirement extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string<BaseAttribute> $fromAttribute
15 |      */
16 |     public function __construct(
17 |         public string $fromAttribute,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Attribute/ExtractsOpenAPIRouteParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ExtractsOpenAPIRouteParameter extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string<BaseAttribute> $fromAttribute
15 |      */
16 |     public function __construct(
17 |         public string $fromAttribute,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Attribute/ExtractsOpenAPIRouteRequestBody.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ExtractsOpenAPIRouteRequestBody extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string<BaseAttribute> $fromAttribute
15 |      */
16 |     public function __construct(
17 |         public string $fromAttribute,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Attribute/ExtractsOpenAPIRouteSecurityRequirement.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ExtractsOpenAPIRouteSecurityRequirement extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string<BaseAttribute> $fromAttribute
15 |      */
16 |     public function __construct(
17 |         public string $fromAttribute,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Attribute/GrantsFeature.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\FeatureInterface;
10 | 
11 | #[Attribute(Attribute::IS_REPEATABLE | Attribute::TARGET_CLASS)]
12 | final readonly class GrantsFeature extends BaseAttribute
13 | {
14 |     public function __construct(
15 |         public FeatureInterface $feature,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/GraphQLRootField.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\GraphQLRootFieldType;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | final readonly class GraphQLRootField extends BaseAttribute
13 | {
14 |     /**
15 |      * @param non-empty-string $name
16 |      */
17 |     public function __construct(
18 |         public string $name,
19 |         public GraphQLRootFieldType $type,
20 |     ) {}
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Attribute/HandlesMiddlewareAttribute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class HandlesMiddlewareAttribute extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string<BaseAttribute> $attribute
15 |      */
16 |     public function __construct(
17 |         public string $attribute,
18 |         public int $priority,
19 |     ) {}
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Attribute/HandlesServerPipeMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\ServerPipeMessageInterface;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | final readonly class HandlesServerPipeMessage extends BaseAttribute
13 | {
14 |     /**
15 |      * @param class-string<ServerPipeMessageInterface> $className
16 |      */
17 |     public function __construct(public string $className) {}
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Attribute/HandlesServerTask.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class HandlesServerTask extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string $className
15 |      */
16 |     public function __construct(public string $className) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/Intercepts.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\HttpInterceptableInterface;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | final readonly class Intercepts extends BaseAttribute
13 | {
14 |     /**
15 |      * @param class-string<HttpInterceptableInterface> $responseClassName
16 |      */
17 |     public function __construct(public string $responseClassName) {}
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Attribute/ListensTo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::IS_REPEATABLE | Attribute::TARGET_CLASS)]
11 | final readonly class ListensTo extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string $eventClass
15 |      */
16 |     public function __construct(public string $eventClass) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/ListensToDoctrineEntityEvents.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ListensToDoctrineEntityEvents extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string $className
15 |      */
16 |     public function __construct(public string $className) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/ListensToDoctrineEvents.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ListensToDoctrineEvents extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/OnParameterResolution.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\HttpControllerParameterResolutionStatus;
10 | 
11 | #[Attribute(Attribute::TARGET_PARAMETER)]
12 | final readonly class OnParameterResolution extends BaseAttribute
13 | {
14 |     /**
15 |      * @param non-empty-string $forwardTo
16 |      */
17 |     public function __construct(
18 |         public string $forwardTo,
19 |         public HttpControllerParameterResolutionStatus $status,
20 |     ) {}
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Attribute/ProvidesAuthenticatedUser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ProvidesAuthenticatedUser extends BaseAttribute
12 | {
13 |     public function __construct(public int $priority) {}
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Attribute/ProvidesOAuth2Grant.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ProvidesOAuth2Grant extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/ProvidesOAuth2Scope.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\OAuth2ScopePattern;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | final readonly class ProvidesOAuth2Scope extends BaseAttribute
13 | {
14 |     public OAuth2ScopePattern $pattern;
15 | 
16 |     /**
17 |      * @param non-empty-string $pattern
18 |      * @param non-empty-string $separator
19 |      */
20 |     public function __construct(
21 |         string $pattern,
22 |         string $separator = ':',
23 |     ) {
24 |         $this->pattern = new OAuth2ScopePattern($pattern, $separator);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Attribute/ProvidesRouteParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ProvidesRouteParameter extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string $class
15 |      */
16 |     public function __construct(public string $class) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/RequiresPhpExtension.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::IS_REPEATABLE | Attribute::TARGET_CLASS)]
11 | final readonly class RequiresPhpExtension extends BaseAttribute
12 | {
13 |     /**
14 |      * @param non-empty-string $name
15 |      */
16 |     public function __construct(public string $name) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/RequiresSingletonCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\SingletonCollectionInterface;
10 | 
11 | #[Attribute(Attribute::IS_REPEATABLE | Attribute::TARGET_CLASS)]
12 | final readonly class RequiresSingletonCollection extends BaseAttribute
13 | {
14 |     public function __construct(public SingletonCollectionInterface $collection) {}
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Attribute/ResolvesHttpControllerParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class ResolvesHttpControllerParameter extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string<BaseAttribute> $attribute
15 |      */
16 |     public function __construct(public string $attribute) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/RespondsToOAuth2Endpoint.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\OAuth2Endpoint;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_FUNCTION)]
12 | final readonly class RespondsToOAuth2Endpoint extends BaseAttribute
13 | {
14 |     public function __construct(
15 |         public OAuth2Endpoint $endpoint,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/RespondsToPromptSubject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class RespondsToPromptSubject extends BaseAttribute
12 | {
13 |     /**
14 |      * @param non-empty-string        $action
15 |      * @param non-empty-string        $subject
16 |      * @param array<non-empty-string> $examples
17 |      */
18 |     public function __construct(
19 |         public string $action,
20 |         public string $subject,
21 |         public array $examples = [],
22 |     ) {}
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Attribute/RespondsToWebSocketJsonRPC.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\JsonRPCMethodInterface;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | final readonly class RespondsToWebSocketJsonRPC extends BaseAttribute
13 | {
14 |     public function __construct(
15 |         public JsonRPCMethodInterface $method,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/RouteParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\CrudAction;
10 | 
11 | #[Attribute(Attribute::TARGET_PARAMETER)]
12 | final readonly class RouteParameter extends BaseAttribute
13 | {
14 |     /**
15 |      * @param non-empty-string $from
16 |      */
17 |     public function __construct(
18 |         public string $from,
19 |         public CrudAction $intent = CrudAction::Read,
20 |     ) {}
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Attribute/ScheduledWithCron.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Cron\CronExpression;
 9 | use Distantmagic\Resonance\Attribute as BaseAttribute;
10 | 
11 | #[Attribute(Attribute::IS_REPEATABLE | Attribute::TARGET_CLASS)]
12 | final readonly class ScheduledWithCron extends BaseAttribute
13 | {
14 |     public CronExpression $expression;
15 | 
16 |     /**
17 |      * @param non-empty-string $expression
18 |      */
19 |     public function __construct(
20 |         string $expression,
21 |         public ?string $name = null,
22 |     ) {
23 |         $this->expression = new CronExpression($expression);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Attribute/ScheduledWithTickTimer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::IS_REPEATABLE | Attribute::TARGET_CLASS)]
11 | final readonly class ScheduledWithTickTimer extends BaseAttribute
12 | {
13 |     public function __construct(public int $interval = 1) {}
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Attribute/SessionAuthenticated.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_PARAMETER)]
11 | final readonly class SessionAuthenticated extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/SideEffect.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\FeatureInterface;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | final readonly class SideEffect extends BaseAttribute
13 | {
14 |     public function __construct(
15 |         public FeatureInterface $feature,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/Singleton.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\SingletonCollectionInterface;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS)]
12 | final readonly class Singleton extends BaseAttribute
13 | {
14 |     /**
15 |      * @param null|class-string $provides
16 |      */
17 |     public function __construct(
18 |         public ?SingletonCollectionInterface $collection = null,
19 |         public ?string $provides = null,
20 |     ) {}
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Attribute/StaticPageLayout.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class StaticPageLayout extends BaseAttribute
12 | {
13 |     public function __construct(public string $name) {}
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Attribute/TwigExtension.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class TwigExtension extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/TwigFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class TwigFilter extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/TwigFunction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class TwigFunction extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/TwigLoader.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class TwigLoader extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/Attribute/ValidatedRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_PARAMETER)]
11 | final readonly class ValidatedRequest extends BaseAttribute
12 | {
13 |     /**
14 |      * @param class-string $validator
15 |      */
16 |     public function __construct(public string $validator) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/ValidatesCSRFToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\RequestDataSource;
10 | 
11 | #[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_FUNCTION)]
12 | final readonly class ValidatesCSRFToken extends BaseAttribute
13 | {
14 |     public function __construct(
15 |         public string $name,
16 |         public RequestDataSource $requestDataSource = RequestDataSource::Post,
17 |     ) {}
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Attribute/WantsFeature.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | use Distantmagic\Resonance\FeatureInterface;
10 | 
11 | #[Attribute(Attribute::IS_REPEATABLE | Attribute::TARGET_CLASS | Attribute::TARGET_FUNCTION)]
12 | final readonly class WantsFeature extends BaseAttribute
13 | {
14 |     public function __construct(
15 |         public FeatureInterface $feature,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Attribute/WebSocketAware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Attribute;
 6 | 
 7 | use Attribute;
 8 | use Distantmagic\Resonance\Attribute as BaseAttribute;
 9 | 
10 | #[Attribute(Attribute::TARGET_CLASS)]
11 | final readonly class WebSocketAware extends BaseAttribute {}
12 | 


--------------------------------------------------------------------------------
/src/AuthenticatedUser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class AuthenticatedUser
 8 | {
 9 |     public function __construct(
10 |         public AuthenticatedUserSource $source,
11 |         public UserInterface $user,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/AuthenticatedUserSource.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum AuthenticatedUserSource
 8 | {
 9 |     case OAuth2;
10 |     case Session;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/AuthenticatedUserStoreInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ServerRequestInterface;
 8 | 
 9 | interface AuthenticatedUserStoreInterface
10 | {
11 |     public function getAuthenticatedUser(ServerRequestInterface $request): ?AuthenticatedUser;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/BackusNaurFormGrammar.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | abstract readonly class BackusNaurFormGrammar
 8 | {
 9 |     abstract public function getGrammarContent(): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/BackusNaurFormGrammar/InlineGrammar.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\BackusNaurFormGrammar;
 6 | 
 7 | use Distantmagic\Resonance\BackusNaurFormGrammar;
 8 | 
 9 | readonly class InlineGrammar extends BackusNaurFormGrammar
10 | {
11 |     public function __construct(
12 |         /**
13 |          * @var non-empty-string
14 |          */
15 |         private string $grammar
16 |     ) {}
17 | 
18 |     public function getGrammarContent(): string
19 |     {
20 |         return $this->grammar;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/BackusNaurFormGrammar/YesNoGrammar.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\BackusNaurFormGrammar;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\BackusNaurFormGrammar;
 9 | 
10 | #[Singleton]
11 | readonly class YesNoGrammar extends BackusNaurFormGrammar
12 | {
13 |     /**
14 |      * @var non-empty-string
15 |      */
16 |     private string $grammar;
17 | 
18 |     public function __construct()
19 |     {
20 |         $this->grammar = 'root ::= "yes" | "no"';
21 |     }
22 | 
23 |     public function getGrammarContent(): string
24 |     {
25 |         return $this->grammar;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/BackusNaurFormGrammar/YesNoMaybeGrammar.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\BackusNaurFormGrammar;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\BackusNaurFormGrammar;
 9 | 
10 | #[Singleton]
11 | readonly class YesNoMaybeGrammar extends BackusNaurFormGrammar
12 | {
13 |     /**
14 |      * @var non-empty-string
15 |      */
16 |     private string $grammar;
17 | 
18 |     public function __construct()
19 |     {
20 |         $this->grammar = 'root ::= "yes" | "no" | "maybe"';
21 |     }
22 | 
23 |     public function getGrammarContent(): string
24 |     {
25 |         return $this->grammar;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/CastableEnumTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | trait CastableEnumTrait
 8 | {
 9 |     public function toConstant(): string
10 |     {
11 |         return $this::class.'::'.$this->getName();
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/src/CastsValidatedDataInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TCastedData of InputValidatedData
 9 |  * @template TValidatedData
10 |  */
11 | interface CastsValidatedDataInterface
12 | {
13 |     /**
14 |      * @param TValidatedData $data
15 |      *
16 |      * @return TCastedData
17 |      */
18 |     public function castValidatedData(mixed $data): InputValidatedData;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Command.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Symfony\Component\Console\Command\Command as SymfonyCommand;
 8 | 
 9 | abstract class Command extends SymfonyCommand
10 | {
11 |     /**
12 |      * Do not use Symfony's command constructor arguments to make it easier on
13 |      * the DI.
14 |      */
15 |     public function __construct()
16 |     {
17 |         parent::__construct();
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/CommonMarkAdmonitionBlock.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\CommonMark\Node\Block\AbstractBlock;
 8 | 
 9 | final class CommonMarkAdmonitionBlock extends AbstractBlock
10 | {
11 |     public function __construct(public readonly string $fenceType)
12 |     {
13 |         parent::__construct();
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/src/CommonMarkAdmonitionExtension.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\CommonMark\Environment\EnvironmentBuilderInterface;
 8 | use League\CommonMark\Extension\ExtensionInterface;
 9 | 
10 | readonly class CommonMarkAdmonitionExtension implements ExtensionInterface
11 | {
12 |     public function register(EnvironmentBuilderInterface $environment): void
13 |     {
14 |         $environment->addBlockStartParser(new CommonMarkAdmonitionBlockStartParser());
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/CommonMarkRenderedContentWithTableOfContentsLinks.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\CommonMark\Node\Block\Document;
 8 | use League\CommonMark\Output\RenderedContent;
 9 | 
10 | class CommonMarkRenderedContentWithTableOfContentsLinks extends RenderedContent
11 | {
12 |     /**
13 |      * @param array<CommonMarkTableOfContentsLink> $tableOfContentsLinks
14 |      */
15 |     public function __construct(
16 |         Document $document,
17 |         string $content,
18 |         public readonly array $tableOfContentsLinks
19 |     ) {
20 |         parent::__construct($document, $content);
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/CommonMarkTableOfContentsLink.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @psalm-suppress PossiblyUnusedProperty used in templates
 9 |  */
10 | readonly class CommonMarkTableOfContentsLink
11 | {
12 |     public function __construct(
13 |         public int $level,
14 |         public string $slug,
15 |         public string $text,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/ConfigurationFile.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class ConfigurationFile
 8 | {
 9 |     /**
10 |      * @param array<string,mixed> $config
11 |      */
12 |     public function __construct(public array $config) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/ConsoleApplication.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Symfony\Component\Console\Application;
 8 | 
 9 | class ConsoleApplication extends Application {}
10 | 


--------------------------------------------------------------------------------
/src/ConstraintDefaultValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class ConstraintDefaultValue
 8 | {
 9 |     public function __construct(public mixed $defaultValue) {}
10 | }
11 | 


--------------------------------------------------------------------------------
/src/ConstraintPath.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Stringable;
 8 | 
 9 | readonly class ConstraintPath implements Stringable
10 | {
11 |     /**
12 |      * @param array<string> $path
13 |      */
14 |     public function __construct(private array $path = []) {}
15 | 
16 |     public function __toString(): string
17 |     {
18 |         return implode('.', $this->path);
19 |     }
20 | 
21 |     public function fork(string $next): self
22 |     {
23 |         return new self([...$this->path, $next]);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/ConstraintReason.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum ConstraintReason: string
 8 | {
 9 |     case FileNotFound = 'file_not_found';
10 |     case FileNotReadable = 'file_not_readable';
11 |     case InvalidDataType = 'invalid_data_type';
12 |     case InvalidEnumValue = 'invalid_enum_value';
13 |     case InvalidFormat = 'invalid_format';
14 |     case InvalidNestedConstraint = 'invalid_nested_constraint';
15 |     case MissingProperty = 'missing_property';
16 |     case NotDirectory = 'not_directory';
17 |     case Ok = 'ok';
18 |     case UnexpectedProperty = 'unexpected_property';
19 | }
20 | 


--------------------------------------------------------------------------------
/src/ConstraintResultStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum ConstraintResultStatus
 8 | {
 9 |     case Invalid;
10 |     case Valid;
11 | 
12 |     public function isValid(): bool
13 |     {
14 |         return ConstraintResultStatus::Valid === $this;
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/ConstraintSourceInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface ConstraintSourceInterface
 8 | {
 9 |     public function getConstraint(): Constraint;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/ConstraintStringFormat.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum ConstraintStringFormat
 8 | {
 9 |     case Mail;
10 |     case Uuid;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/ConstraintValidationException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | class ConstraintValidationException extends RuntimeException
10 | {
11 |     public function __construct(ConstraintResult $constraintResult)
12 |     {
13 |         parent::__construct((string) new ConstraintResultErrorMessage($constraintResult));
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/src/ContentSecurityPolicyType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum ContentSecurityPolicyType
 8 | {
 9 |     case Html;
10 |     case Json;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/ContentType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum ContentType: string
 8 | {
 9 |     case ApplicationJson = 'application/json';
10 |     case ApplicationOctetStream = 'application/octet-stream';
11 |     case FontTtf = 'font/ttf';
12 |     case ImageJpeg = 'image/jpeg';
13 |     case ImageSvg = 'image/svg+xml';
14 |     case TextCss = 'text/css';
15 |     case TextHtml = 'text/html';
16 |     case TextJavaScript = 'text/javascript';
17 |     case TextPlain = 'text/plain';
18 | }
19 | 


--------------------------------------------------------------------------------
/src/CronJob.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | abstract readonly class CronJob implements CronJobInterface
 8 | {
 9 |     public function shouldRegister(): bool
10 |     {
11 |         return true;
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/src/CronJobAggregate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Set;
 8 | 
 9 | readonly class CronJobAggregate
10 | {
11 |     /**
12 |      * @var Set<CronRegisteredJob>
13 |      */
14 |     public Set $cronJobs;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->cronJobs = new Set();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/CronJobInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface CronJobInterface extends RegisterableInterface
 8 | {
 9 |     public function onCronTick(): void;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/CronJobRunner.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Psr\Log\LoggerInterface;
 9 | 
10 | use function Distantmagic\Resonance\helpers\coroutineMustGo;
11 | 
12 | #[Singleton]
13 | readonly class CronJobRunner
14 | {
15 |     public function __construct(private LoggerInterface $logger) {}
16 | 
17 |     public function runCronJob(CronRegisteredJob $cronRegisteredJob): void
18 |     {
19 |         coroutineMustGo(function () use ($cronRegisteredJob): void {
20 |             $this->logger->info(sprintf('cron_job_start(%s)', $cronRegisteredJob->name));
21 |             $cronRegisteredJob->cronJob->onCronTick();
22 |         });
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/CronRegisteredJob.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Cron\CronExpression;
 8 | 
 9 | readonly class CronRegisteredJob
10 | {
11 |     public function __construct(
12 |         public CronJobInterface $cronJob,
13 |         public CronExpression $expression,
14 |         public string $name,
15 |     ) {}
16 | }
17 | 


--------------------------------------------------------------------------------
/src/CrudAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum CrudAction
 8 | {
 9 |     case Delete;
10 |     case Read;
11 |     case Update;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/CrudActionGate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TSubject of CrudActionSubjectInterface
 9 |  *
10 |  * @template-implements CrudActionGateInterface<TSubject>
11 |  */
12 | abstract readonly class CrudActionGate implements CrudActionGateInterface {}
13 | 


--------------------------------------------------------------------------------
/src/CrudActionGateInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TSubject of CrudActionSubjectInterface
 9 |  */
10 | interface CrudActionGateInterface
11 | {
12 |     /**
13 |      * @param TSubject $subject
14 |      */
15 |     public function can(
16 |         ?AuthenticatedUser $authenticatedUser,
17 |         CrudActionSubjectInterface $subject,
18 |         CrudAction $crudAction,
19 |     ): bool;
20 | 
21 |     public function requiresAuthenticatedUser(CrudAction $crudAction): bool;
22 | }
23 | 


--------------------------------------------------------------------------------
/src/CrudActionSubjectInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface CrudActionSubjectInterface {}
8 | 


--------------------------------------------------------------------------------
/src/CurlErrorMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use CurlHandle;
 8 | use Stringable;
 9 | 
10 | readonly class CurlErrorMessage implements Stringable
11 | {
12 |     public function __construct(private CurlHandle $curlHandle) {}
13 | 
14 |     public function __toString(): string
15 |     {
16 |         return sprintf(
17 |             'curl request failed because of error: (%d)"%s"',
18 |             curl_errno($this->curlHandle),
19 |             curl_error($this->curlHandle),
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/CurlException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use CurlHandle;
 8 | use RuntimeException;
 9 | 
10 | class CurlException extends RuntimeException
11 | {
12 |     public function __construct(CurlHandle $ch)
13 |     {
14 |         parent::__construct((string) new CurlErrorMessage($ch));
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/DatabaseConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class DatabaseConfiguration
10 | {
11 |     /**
12 |      * @var Map<non-empty-string,DatabaseConnectionPoolConfiguration>
13 |      */
14 |     public Map $connectionPoolConfiguration;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->connectionPoolConfiguration = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/DatabaseConnectionPoolDriverName.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum DatabaseConnectionPoolDriverName: string
 8 | {
 9 |     use EnumValuesTrait;
10 | 
11 |     case MySQL = 'mysql';
12 |     case PostgreSQL = 'postgresql';
13 |     case SQLite = 'sqlite';
14 | }
15 | 


--------------------------------------------------------------------------------
/src/DatabaseEntity.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class DatabaseEntity implements DatabaseEntityInterface {}
8 | 


--------------------------------------------------------------------------------
/src/DatabaseEntityInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface DatabaseEntityInterface {}
8 | 


--------------------------------------------------------------------------------
/src/DatabaseQueryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TResult
 9 |  */
10 | interface DatabaseQueryInterface
11 | {
12 |     /**
13 |      * I wish PHP had generics.
14 |      *
15 |      * @return TResult
16 |      */
17 |     public function execute();
18 | 
19 |     public function isIterable(): bool;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/DependencyInjectionContainerException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Exception;
 8 | use Psr\Container\ContainerExceptionInterface;
 9 | use Throwable;
10 | 
11 | class DependencyInjectionContainerException extends Exception implements ContainerExceptionInterface
12 | {
13 |     public function __construct(
14 |         string $message,
15 |         ?Throwable $previous = null,
16 |     ) {
17 |         parent::__construct($message, 0, $previous);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/DialogueController.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class DialogueController implements DialogueControllerInterface {}
8 | 


--------------------------------------------------------------------------------
/src/DialogueControllerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface DialogueControllerInterface
 8 | {
 9 |     public function getRootDialogueNode(): DialogueNodeInterface;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/DialogueInput.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class DialogueInput implements DialogueInputInterface {}
8 | 


--------------------------------------------------------------------------------
/src/DialogueInput/UserInput.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\DialogueInput;
 6 | 
 7 | use Distantmagic\Resonance\DialogueInputInterface;
 8 | 
 9 | readonly class UserInput implements DialogueInputInterface
10 | {
11 |     public function __construct(
12 |         private string $content,
13 |     ) {}
14 | 
15 |     public function getContent(): string
16 |     {
17 |         return $this->content;
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/DialogueInputInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface DialogueInputInterface
 8 | {
 9 |     public function getContent(): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/DialogueMessageChunk.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Stringable;
 8 | 
 9 | readonly class DialogueMessageChunk implements Stringable
10 | {
11 |     public function __construct(
12 |         public string $content,
13 |         public bool $isFailed,
14 |         public bool $isLastToken,
15 |     ) {}
16 | 
17 |     public function __toString(): string
18 |     {
19 |         return $this->content;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/DialogueMessageProducer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | abstract readonly class DialogueMessageProducer implements DialogueMessageProducerInterface
 8 | {
 9 |     public function __toString(): string
10 |     {
11 |         $ret = '';
12 | 
13 |         foreach ($this as $chunk) {
14 |             $ret .= (string) $chunk;
15 |         }
16 | 
17 |         return $ret;
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/DialogueMessageProducer/EmptyMessageProducer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\DialogueMessageProducer;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\DialogueMessageChunk;
 9 | use Distantmagic\Resonance\DialogueMessageProducer;
10 | use Generator;
11 | 
12 | #[Singleton]
13 | readonly class EmptyMessageProducer extends DialogueMessageProducer
14 | {
15 |     public function getIterator(): Generator
16 |     {
17 |         yield new DialogueMessageChunk(
18 |             content: '',
19 |             isFailed: false,
20 |             isLastToken: true,
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/DialogueMessageProducerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use IteratorAggregate;
 8 | use Stringable;
 9 | 
10 | /**
11 |  * @template-extends IteratorAggregate<DialogueMessageChunk>
12 |  */
13 | interface DialogueMessageProducerInterface extends IteratorAggregate, Stringable {}
14 | 


--------------------------------------------------------------------------------
/src/DialogueNodeSideEffect.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class DialogueNodeSideEffect implements DialogueNodeSideEffectInterface {}
8 | 


--------------------------------------------------------------------------------
/src/DialogueNodeSideEffectInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface DialogueNodeSideEffectInterface {}
8 | 


--------------------------------------------------------------------------------
/src/DialogueResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use function Distantmagic\Resonance\helpers\generatorGetReturn;
 8 | 
 9 | abstract readonly class DialogueResponse implements DialogueResponseInterface
10 | {
11 |     public function resolveResponse(DialogueInputInterface $dialogueInput): DialogueResponseResolutionInterface
12 |     {
13 |         $resolveGenerator = $this->resolveResponseWithProgress($dialogueInput);
14 | 
15 |         return generatorGetReturn($resolveGenerator);
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/DialogueResponseInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Generator;
 8 | 
 9 | interface DialogueResponseInterface
10 | {
11 |     public function getCost(): int;
12 | 
13 |     public function resolveResponse(DialogueInputInterface $dialogueInput): DialogueResponseResolutionInterface;
14 | 
15 |     /**
16 |      * @return Generator<mixed,LlmCompletionProgressInterface,mixed,DialogueResponseResolutionInterface>
17 |      */
18 |     public function resolveResponseWithProgress(DialogueInputInterface $dialogueInput): Generator;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/DialogueResponseResolutionInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface DialogueResponseResolutionInterface
 8 | {
 9 |     public function getFollowUp(): ?DialogueNodeInterface;
10 | 
11 |     public function getStatus(): DialogueResponseResolutionStatus;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/DialogueResponseResolutionStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum DialogueResponseResolutionStatus
 8 | {
 9 |     case CannotRespond;
10 |     case CanRespond;
11 |     case Failed;
12 | 
13 |     public function canRespond(): bool
14 |     {
15 |         return self::CanRespond === $this;
16 |     }
17 | 
18 |     public function isFailed(): bool
19 |     {
20 |         return self::Failed === $this;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/DoctrineEntityListener.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class DoctrineEntityListener {}
8 | 


--------------------------------------------------------------------------------
/src/DoctrineEventSubscriber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Doctrine\Common\EventSubscriber;
 8 | 
 9 | abstract readonly class DoctrineEventSubscriber implements EventSubscriber {}
10 | 


--------------------------------------------------------------------------------
/src/DoctrineMySQLDriver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\RequiresPhpExtension;
 8 | use Distantmagic\Resonance\Attribute\Singleton;
 9 | use Doctrine\DBAL\Driver\AbstractMySQLDriver;
10 | 
11 | /**
12 |  * Internal Doctrine class uses deprecated `VersionAwarePlatformDriver`
13 |  * interface, so we can do nothing about that error here.
14 |  *
15 |  * @psalm-suppress DeprecatedInterface
16 |  */
17 | #[RequiresPhpExtension('pdo')]
18 | #[Singleton]
19 | class DoctrineMySQLDriver extends AbstractMySQLDriver
20 | {
21 |     use DoctrineDriverConnectTrait;
22 | }
23 | 


--------------------------------------------------------------------------------
/src/DoctrinePostgreSQLDriver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\RequiresPhpExtension;
 8 | use Distantmagic\Resonance\Attribute\Singleton;
 9 | use Doctrine\DBAL\Driver\AbstractPostgreSQLDriver;
10 | 
11 | /**
12 |  * Internal Doctrine class uses deprecated `VersionAwarePlatformDriver`
13 |  * interface, so we can do nothing about that error here.
14 |  *
15 |  * @psalm-suppress DeprecatedInterface
16 |  */
17 | #[RequiresPhpExtension('pdo')]
18 | #[Singleton]
19 | class DoctrinePostgreSQLDriver extends AbstractPostgreSQLDriver
20 | {
21 |     use DoctrineDriverConnectTrait;
22 | }
23 | 


--------------------------------------------------------------------------------
/src/DoctrineSQLiteDriver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\RequiresPhpExtension;
 8 | use Distantmagic\Resonance\Attribute\Singleton;
 9 | use Doctrine\DBAL\Driver\AbstractSQLiteDriver;
10 | 
11 | /**
12 |  * Internal Doctrine class uses deprecated `VersionAwarePlatformDriver`
13 |  * interface, so we can do nothing about that error here.
14 |  *
15 |  * @psalm-suppress DeprecatedInterface
16 |  */
17 | #[RequiresPhpExtension('pdo')]
18 | #[Singleton]
19 | class DoctrineSQLiteDriver extends AbstractSQLiteDriver
20 | {
21 |     use DoctrineDriverConnectTrait;
22 | }
23 | 


--------------------------------------------------------------------------------
/src/EnumValuesTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | trait EnumValuesTrait
 8 | {
 9 |     /**
10 |      * @return array<string>
11 |      */
12 |     public static function values(): array
13 |     {
14 |         return array_column(self::cases(), 'value');
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Environment.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum Environment: string
 8 | {
 9 |     use EnumValuesTrait;
10 | 
11 |     case Development = 'development';
12 |     case Production = 'production';
13 | }
14 | 


--------------------------------------------------------------------------------
/src/ErrorHttpResponderDependencies.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\HttpResponder\NotAcceptable;
 9 | 
10 | #[Singleton]
11 | readonly class ErrorHttpResponderDependencies
12 | {
13 |     public function __construct(
14 |         public HtmlErrorTemplateInterface $htmlTemplate,
15 |         public JsonErrorTemplateInterface $jsonTemplate,
16 |         public NotAcceptable $notAcceptable,
17 |         public SecurityPolicyHeaders $securityPolicyHeaders,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/ErrorTemplateInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface;
 8 | use Psr\Http\Message\ServerRequestInterface;
 9 | 
10 | interface ErrorTemplateInterface
11 | {
12 |     public function renderHttpError(ServerRequestInterface $request, ResponseInterface $response, HttpError $httpError): HttpInterceptableInterface|HttpResponderInterface|ResponseInterface;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/EsbuildPreloadable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class EsbuildPreloadable
 8 | {
 9 |     public function __construct(
10 |         public string $pathname,
11 |         public EsbuildPreloadableType $type,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/EsbuildPreloadableType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum EsbuildPreloadableType
 8 | {
 9 |     case Font;
10 |     case Image;
11 |     case JavaScriptModule;
12 |     case Stylesheet;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Event.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | readonly class Event {}
8 | 


--------------------------------------------------------------------------------
/src/Event/HttpResponseReady.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Event;
 6 | 
 7 | use Distantmagic\Resonance\Event;
 8 | use Distantmagic\Resonance\HttpResponderInterface;
 9 | use Distantmagic\Resonance\LoggableInterface;
10 | use Psr\Http\Message\ServerRequestInterface;
11 | 
12 | final readonly class HttpResponseReady extends Event implements LoggableInterface
13 | {
14 |     public function __construct(
15 |         public HttpResponderInterface $responder,
16 |         public ServerRequestInterface $request,
17 |     ) {}
18 | 
19 |     public function shouldLog(): bool
20 |     {
21 |         return false;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Event/HttpServerBeforeStop.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Event;
 6 | 
 7 | use Distantmagic\Resonance\Event;
 8 | use Swoole\Server;
 9 | 
10 | final readonly class HttpServerBeforeStop extends Event
11 | {
12 |     public function __construct(public Server $server) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Event/HttpServerStarted.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Event;
 6 | 
 7 | use Distantmagic\Resonance\Event;
 8 | use Swoole\Server;
 9 | 
10 | /**
11 |  * @psalm-suppress PossiblyUnusedProperty used in listeners
12 |  */
13 | final readonly class HttpServerStarted extends Event
14 | {
15 |     public function __construct(public Server $server) {}
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Event/MailBounced.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Event;
 6 | 
 7 | use Distantmagic\Resonance\Event;
 8 | use Distantmagic\Resonance\MailBounceReportInterface;
 9 | 
10 | /**
11 |  * @psalm-suppress PossiblyUnusedProperty used in listeners
12 |  */
13 | final readonly class MailBounced extends Event
14 | {
15 |     public function __construct(public MailBounceReportInterface $report) {}
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Event/UnhandledException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Event;
 6 | 
 7 | use Distantmagic\Resonance\Event;
 8 | use Throwable;
 9 | 
10 | final readonly class UnhandledException extends Event
11 | {
12 |     public function __construct(public Throwable $throwable) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/EventListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TEvent of object
 9 |  * @template TResult
10 |  *
11 |  * @template-implements EventListenerInterface<TEvent, TResult>
12 |  */
13 | abstract readonly class EventListener implements EventListenerInterface
14 | {
15 |     public function shouldRegister(): bool
16 |     {
17 |         return true;
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/EventListenerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TEvent of object
 9 |  * @template TResult
10 |  */
11 | interface EventListenerInterface extends RegisterableInterface
12 | {
13 |     /**
14 |      * I wish PHP had generics.
15 |      *
16 |      * @param TEvent $event
17 |      *
18 |      * @return TResult
19 |      */
20 |     public function handle(object $event);
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Feature.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum Feature implements FeatureInterface
 8 | {
 9 |     use NameableEnumTrait;
10 | 
11 |     case Doctrine;
12 |     case GrpcClient;
13 |     case HttpSession;
14 |     case Mailer;
15 |     case OAuth2;
16 |     case Postfix;
17 |     case StaticPages;
18 |     case SwooleTaskServer;
19 |     case WebSocket;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/FeatureInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface FeatureInterface extends NameableInterface {}
8 | 


--------------------------------------------------------------------------------
/src/FooInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface FooInterface {}
8 | 


--------------------------------------------------------------------------------
/src/FrontMatterCollectionReference.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class FrontMatterCollectionReference
 8 | {
 9 |     /**
10 |      * @param non-empty-string      $name
11 |      * @param null|non-empty-string $next
12 |      */
13 |     public function __construct(
14 |         public string $name,
15 |         public ?string $next,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/GeneratorHelper.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | final readonly class GeneratorHelper {}
8 | 


--------------------------------------------------------------------------------
/src/GraphQLFieldableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface GraphQLFieldableInterface
 8 | {
 9 |     public function toGraphQLField(): array;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/GraphQLResolverException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use GraphQL\Error\ClientAware;
 8 | use RuntimeException;
 9 | 
10 | class GraphQLResolverException extends RuntimeException implements ClientAware
11 | {
12 |     public function isClientSafe(): bool
13 |     {
14 |         return true;
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/GraphQLResolverException/Forbidden.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\GraphQLResolverException;
 6 | 
 7 | use Distantmagic\Resonance\GraphQLResolverException;
 8 | 
 9 | class Forbidden extends GraphQLResolverException {}
10 | 


--------------------------------------------------------------------------------
/src/GraphQLResolverException/InvalidReturnType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\GraphQLResolverException;
 6 | 
 7 | use Distantmagic\Resonance\GraphQLResolverException;
 8 | 
 9 | class InvalidReturnType extends GraphQLResolverException {}
10 | 


--------------------------------------------------------------------------------
/src/GraphQLReusableDatabaseQueryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TResult
 9 |  *
10 |  * @template-extends DatabaseQueryInterface<TResult>
11 |  */
12 | interface GraphQLReusableDatabaseQueryInterface extends DatabaseQueryInterface
13 | {
14 |     public function reusableQueryId(): string;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/GraphQLRootFieldType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum GraphQLRootFieldType
 8 | {
 9 |     case Mutation;
10 |     case Query;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/GraphQLSchemaRootFieldInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use GraphQL\Type\Definition\CompositeType;
 8 | use GraphQL\Type\Definition\HasFieldsType;
 9 | use GraphQL\Type\Definition\ImplementingType;
10 | use GraphQL\Type\Definition\NamedType;
11 | use GraphQL\Type\Definition\NullableType;
12 | use GraphQL\Type\Definition\OutputType;
13 | 
14 | interface GraphQLSchemaRootFieldInterface extends CompositeType, HasFieldsType, ImplementingType, NamedType, NullableType, OutputType {}
15 | 


--------------------------------------------------------------------------------
/src/GrpcConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class GrpcConfiguration
10 | {
11 |     /**
12 |      * @var Map<non-empty-string,GrpcPoolConfiguration>
13 |      */
14 |     public Map $poolConfiguration;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->poolConfiguration = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/HtmlErrorTemplateInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface HtmlErrorTemplateInterface extends ErrorTemplateInterface {}
8 | 


--------------------------------------------------------------------------------
/src/HttpControllerParameterResolution.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TValue
 9 |  */
10 | readonly class HttpControllerParameterResolution
11 | {
12 |     /**
13 |      * @param TValue $value
14 |      */
15 |     public function __construct(
16 |         public HttpControllerParameterResolutionStatus $status,
17 |         public mixed $value = null,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/HttpControllerParameterResolutionStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum HttpControllerParameterResolutionStatus
 8 | {
 9 |     case Forbidden;
10 |     case MissingUrlParameterValue;
11 |     case NoResolver;
12 |     case NotFound;
13 |     case Success;
14 |     case ValidationErrors;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/HttpControllerParameterResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TAttribute of Attribute
 9 |  *
10 |  * @template-implements HttpControllerParameterResolverInterface<TAttribute>
11 |  */
12 | abstract readonly class HttpControllerParameterResolver implements HttpControllerParameterResolverInterface {}
13 | 


--------------------------------------------------------------------------------
/src/HttpControllerParameterResolverInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface;
 8 | use Psr\Http\Message\ServerRequestInterface;
 9 | 
10 | /**
11 |  * @template TAttribute of Attribute
12 |  */
13 | interface HttpControllerParameterResolverInterface
14 | {
15 |     /**
16 |      * @param HttpControllerParameter<TAttribute> $parameter
17 |      * @param TAttribute                          $attribute
18 |      */
19 |     public function resolve(
20 |         ServerRequestInterface $request,
21 |         ResponseInterface $response,
22 |         HttpControllerParameter $parameter,
23 |         Attribute $attribute,
24 |     ): HttpControllerParameterResolution;
25 | }
26 | 


--------------------------------------------------------------------------------
/src/HttpError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ServerRequestInterface;
 8 | 
 9 | abstract readonly class HttpError
10 | {
11 |     abstract public function code(): int;
12 | 
13 |     abstract public function message(ServerRequestInterface $request): string;
14 | 
15 |     public function __construct(protected TranslatorBridge $translatorBridge) {}
16 | }
17 | 


--------------------------------------------------------------------------------
/src/HttpError/BadRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpError;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\HttpError;
 9 | use Psr\Http\Message\ServerRequestInterface;
10 | 
11 | #[Singleton]
12 | final readonly class BadRequest extends HttpError
13 | {
14 |     public function code(): int
15 |     {
16 |         return 400;
17 |     }
18 | 
19 |     public function message(ServerRequestInterface $request): string
20 |     {
21 |         return $this->translatorBridge->trans($request, 'error.bad_request');
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/HttpError/Forbidden.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpError;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\HttpError;
 9 | use Psr\Http\Message\ServerRequestInterface;
10 | 
11 | #[Singleton]
12 | final readonly class Forbidden extends HttpError
13 | {
14 |     public function code(): int
15 |     {
16 |         return 403;
17 |     }
18 | 
19 |     public function message(ServerRequestInterface $request): string
20 |     {
21 |         return $this->translatorBridge->trans($request, 'error.forbidden');
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/HttpError/MethodNotAllowed.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpError;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\HttpError;
 9 | use Psr\Http\Message\ServerRequestInterface;
10 | 
11 | #[Singleton]
12 | final readonly class MethodNotAllowed extends HttpError
13 | {
14 |     public function code(): int
15 |     {
16 |         return 405;
17 |     }
18 | 
19 |     public function message(ServerRequestInterface $request): string
20 |     {
21 |         return $this->translatorBridge->trans($request, 'error.method_not_allowed');
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/HttpError/PageNotFound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpError;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\HttpError;
 9 | use Psr\Http\Message\ServerRequestInterface;
10 | 
11 | #[Singleton]
12 | final readonly class PageNotFound extends HttpError
13 | {
14 |     public function code(): int
15 |     {
16 |         return 404;
17 |     }
18 | 
19 |     public function message(ServerRequestInterface $request): string
20 |     {
21 |         return $this->translatorBridge->trans($request, 'error.page_not_found');
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/HttpError/ServerError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpError;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\HttpError;
 9 | use Psr\Http\Message\ServerRequestInterface;
10 | 
11 | #[Singleton]
12 | final readonly class ServerError extends HttpError
13 | {
14 |     public function code(): int
15 |     {
16 |         return 500;
17 |     }
18 | 
19 |     public function message(ServerRequestInterface $request): string
20 |     {
21 |         return $this->translatorBridge->trans($request, 'error.server_error');
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/HttpInterceptableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface;
 8 | use Psr\Http\Message\ServerRequestInterface;
 9 | 
10 | interface HttpInterceptableInterface
11 | {
12 |     public function getResponse(): ResponseInterface;
13 | 
14 |     public function getServerRequest(): ServerRequestInterface;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/HttpInterceptor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\StreamInterface;
 8 | use Stringable;
 9 | 
10 | /**
11 |  * @template TClass
12 |  *
13 |  * @template-implements HttpInterceptorInterface<TClass>
14 |  */
15 | abstract readonly class HttpInterceptor implements HttpInterceptorInterface
16 | {
17 |     public function createStream(string|Stringable $content): StreamInterface
18 |     {
19 |         return new PsrStringStream($content);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/HttpInterceptorAggregate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class HttpInterceptorAggregate
10 | {
11 |     /**
12 |      * @var Map<
13 |      *     class-string<HttpInterceptableInterface>,
14 |      *     HttpInterceptorInterface
15 |      * >
16 |      */
17 |     public Map $interceptors;
18 | 
19 |     public function __construct()
20 |     {
21 |         $this->interceptors = new Map();
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/HttpInterceptorInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface;
 8 | use Psr\Http\Message\ServerRequestInterface;
 9 | 
10 | /**
11 |  * @template TClass
12 |  */
13 | interface HttpInterceptorInterface
14 | {
15 |     /**
16 |      * @param TClass $intercepted
17 |      */
18 |     public function intercept(
19 |         ServerRequestInterface $request,
20 |         ResponseInterface $response,
21 |         object $intercepted,
22 |     ): HttpInterceptableInterface|HttpResponderInterface|ResponseInterface;
23 | }
24 | 


--------------------------------------------------------------------------------
/src/HttpMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TAttribute of Attribute
 9 |  *
10 |  * @template-implements HttpMiddlewareInterface<TAttribute>
11 |  */
12 | abstract readonly class HttpMiddleware implements HttpMiddlewareInterface {}
13 | 


--------------------------------------------------------------------------------
/src/HttpMiddlewareAttribute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class HttpMiddlewareAttribute
 8 | {
 9 |     public function __construct(
10 |         public readonly HttpMiddlewareInterface $httpMiddleware,
11 |         public readonly Attribute $attribute,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/HttpMiddlewareInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface;
 8 | use Psr\Http\Message\ServerRequestInterface;
 9 | 
10 | /**
11 |  * @template TAttribute of Attribute
12 |  */
13 | interface HttpMiddlewareInterface
14 | {
15 |     /**
16 |      * @param TAttribute $attribute
17 |      */
18 |     public function preprocess(
19 |         ServerRequestInterface $request,
20 |         ResponseInterface $response,
21 |         Attribute $attribute,
22 |         HttpInterceptableInterface|HttpResponderInterface $next,
23 |     ): HttpInterceptableInterface|HttpResponderInterface|ResponseInterface;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/HttpResponder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\StreamInterface;
 8 | use Stringable;
 9 | 
10 | abstract readonly class HttpResponder implements HttpResponderInterface
11 | {
12 |     public function createStream(string|Stringable $content): StreamInterface
13 |     {
14 |         return new PsrStringStream($content);
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/HttpResponder/Error/BadRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpResponder\Error;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\ErrorHttpResponderDependencies;
 9 | use Distantmagic\Resonance\HttpError\BadRequest as BadRequestEntity;
10 | use Distantmagic\Resonance\HttpResponder\Error;
11 | 
12 | #[Singleton]
13 | final readonly class BadRequest extends Error
14 | {
15 |     public function __construct(
16 |         ErrorHttpResponderDependencies $errorHttpResponderDependencies,
17 |         BadRequestEntity $httpError,
18 |     ) {
19 |         parent::__construct($errorHttpResponderDependencies, $httpError);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/HttpResponder/Error/Forbidden.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpResponder\Error;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\ErrorHttpResponderDependencies;
 9 | use Distantmagic\Resonance\HttpError\Forbidden as ForbiddenEntity;
10 | use Distantmagic\Resonance\HttpResponder\Error;
11 | 
12 | #[Singleton]
13 | final readonly class Forbidden extends Error
14 | {
15 |     public function __construct(
16 |         ErrorHttpResponderDependencies $errorHttpResponderDependencies,
17 |         ForbiddenEntity $httpError,
18 |     ) {
19 |         parent::__construct($errorHttpResponderDependencies, $httpError);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/HttpResponder/Error/MethodNotAllowed.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpResponder\Error;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\ErrorHttpResponderDependencies;
 9 | use Distantmagic\Resonance\HttpError\MethodNotAllowed as MethodNotAllowedEntity;
10 | use Distantmagic\Resonance\HttpResponder\Error;
11 | 
12 | #[Singleton]
13 | final readonly class MethodNotAllowed extends Error
14 | {
15 |     public function __construct(
16 |         ErrorHttpResponderDependencies $errorHttpResponderDependencies,
17 |         MethodNotAllowedEntity $httpError,
18 |     ) {
19 |         parent::__construct($errorHttpResponderDependencies, $httpError);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/HttpResponder/Error/PageNotFound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpResponder\Error;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\ErrorHttpResponderDependencies;
 9 | use Distantmagic\Resonance\HttpError\PageNotFound as PageNotFoundEntity;
10 | use Distantmagic\Resonance\HttpResponder\Error;
11 | 
12 | #[Singleton]
13 | final readonly class PageNotFound extends Error
14 | {
15 |     public function __construct(
16 |         ErrorHttpResponderDependencies $errorHttpResponderDependencies,
17 |         PageNotFoundEntity $httpError,
18 |     ) {
19 |         parent::__construct($errorHttpResponderDependencies, $httpError);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/HttpResponder/OAuth2.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpResponder;
 6 | 
 7 | use Distantmagic\Resonance\HttpResponder;
 8 | 
 9 | abstract readonly class OAuth2 extends HttpResponder {}
10 | 


--------------------------------------------------------------------------------
/src/HttpResponder/Redirect.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\HttpResponder;
 6 | 
 7 | use Distantmagic\Resonance\HttpResponder;
 8 | use Psr\Http\Message\ResponseInterface;
 9 | use Psr\Http\Message\ServerRequestInterface;
10 | 
11 | readonly class Redirect extends HttpResponder
12 | {
13 |     public function __construct(
14 |         private string $location,
15 |         private int $code = 303,
16 |     ) {}
17 | 
18 |     public function respond(ServerRequestInterface $request, ResponseInterface $response): ResponseInterface
19 |     {
20 |         return $response
21 |             ->withStatus($this->code)
22 |             ->withHeader('location', $this->location)
23 |         ;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/HttpResponderCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class HttpResponderCollection
10 | {
11 |     /**
12 |      * @var Map<non-empty-string,HttpResponderWithAttribute> $httpResponders
13 |      */
14 |     public Map $httpResponders;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->httpResponders = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/HttpResponderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface;
 8 | use Psr\Http\Message\ServerRequestInterface;
 9 | 
10 | interface HttpResponderInterface
11 | {
12 |     public function respond(ServerRequestInterface $request, ResponseInterface $response): HttpInterceptableInterface|ResponseInterface|self;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/HttpResponderLoggableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface HttpResponderLoggableInterface extends HttpResponderInterface
 8 | {
 9 |     public function shoudLog(): bool;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/HttpRouteMatch.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class HttpRouteMatch
10 | {
11 |     /**
12 |      * @var Map<string, string>
13 |      */
14 |     public Map $routeVars;
15 | 
16 |     /**
17 |      * @param null|non-empty-string $uniqueResponderId
18 |      * @param array<string, string> $routeVars
19 |      */
20 |     public function __construct(
21 |         public HttpRouteMatchStatus $status,
22 |         public ?string $uniqueResponderId = null,
23 |         array $routeVars = [],
24 |     ) {
25 |         $this->routeVars = new Map($routeVars);
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/HttpRouteMatchStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum HttpRouteMatchStatus
 8 | {
 9 |     case Found;
10 |     case MethodNotAllowed;
11 |     case NotFound;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/HttpRouteParameterBinderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ResponseInterface;
 8 | use Psr\Http\Message\ServerRequestInterface;
 9 | 
10 | interface HttpRouteParameterBinderInterface
11 | {
12 |     public function provide(
13 |         ServerRequestInterface $request,
14 |         ResponseInterface $response,
15 |         string $routeParameterValue,
16 |     ): ?object;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/HttpRouteSymbolInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface HttpRouteSymbolInterface extends NameableInterface
 8 | {
 9 |     public function toConstant(): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/InputValidatedData.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class InputValidatedData {}
8 | 


--------------------------------------------------------------------------------
/src/InputValidatedData/JsonRPCMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\InputValidatedData;
 6 | 
 7 | use Distantmagic\Resonance\InputValidatedData;
 8 | use Distantmagic\Resonance\JsonRPCMethodInterface;
 9 | 
10 | /**
11 |  * @template TPayload
12 |  */
13 | readonly class JsonRPCMessage extends InputValidatedData
14 | {
15 |     /**
16 |      * @param TPayload $payload
17 |      */
18 |     public function __construct(
19 |         public JsonRPCMethodInterface $method,
20 |         public mixed $payload,
21 |         public ?string $requestId,
22 |     ) {}
23 | }
24 | 


--------------------------------------------------------------------------------
/src/InputValidationResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TValidatedModel of InputValidatedData
 9 |  */
10 | readonly class InputValidationResult
11 | {
12 |     /**
13 |      * @param null|TValidatedModel $inputValidatedData
14 |      */
15 |     public function __construct(
16 |         public ?InputValidatedData $inputValidatedData,
17 |         public ConstraintResult $constraintResult,
18 |     ) {}
19 | 
20 |     public function getErrorMessage(): string
21 |     {
22 |         return (string) (new ConstraintResultErrorMessage($this->constraintResult));
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/InputValidator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TCastedData of InputValidatedData
 9 |  * @template TValidatedData
10 |  *
11 |  * @template-implements CastsValidatedDataInterface<TCastedData,TValidatedData>
12 |  */
13 | abstract readonly class InputValidator implements CastsValidatedDataInterface, ConstraintSourceInterface {}
14 | 


--------------------------------------------------------------------------------
/src/InputValidatorCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class InputValidatorCollection
10 | {
11 |     /**
12 |      * @var Map<class-string,InputValidator> $inputValidators
13 |      */
14 |     public Map $inputValidators;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->inputValidators = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/JsonErrorTemplate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Psr\Http\Message\ResponseInterface;
 9 | use Psr\Http\Message\ServerRequestInterface;
10 | 
11 | #[Singleton(provides: JsonErrorTemplateInterface::class)]
12 | readonly class JsonErrorTemplate implements JsonErrorTemplateInterface
13 | {
14 |     public function renderHttpError(ServerRequestInterface $request, ResponseInterface $response, HttpError $httpError): HttpInterceptableInterface
15 |     {
16 |         return new JsonTemplate([
17 |             'code' => $httpError->code(),
18 |             'message' => $httpError->message($request),
19 |         ]);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/JsonErrorTemplateInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface JsonErrorTemplateInterface extends ErrorTemplateInterface {}
8 | 


--------------------------------------------------------------------------------
/src/JsonRPCMethodInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface JsonRPCMethodInterface
 8 | {
 9 |     public function getValue(): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/JsonRPCMethodValidatorInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface JsonRPCMethodValidatorInterface
 8 | {
 9 |     /**
10 |      * @return array<JsonRPCMethodInterface>
11 |      */
12 |     public function cases(): array;
13 | 
14 |     public function castToRPCMethod(string $methodName): JsonRPCMethodInterface;
15 | 
16 |     /**
17 |      * @return array<string>
18 |      */
19 |     public function values(): array;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/JsonRPCRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @psalm-suppress PossiblyUnusedProperty used in applications
 9 |  *
10 |  * @template TPayload
11 |  */
12 | readonly class JsonRPCRequest
13 | {
14 |     /**
15 |      * @param TPayload $payload
16 |      */
17 |     public function __construct(
18 |         public JsonRPCMethodInterface $method,
19 |         public mixed $payload,
20 |         public string $requestId,
21 |     ) {}
22 | }
23 | 


--------------------------------------------------------------------------------
/src/JsonRPCResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Stringable;
 8 | 
 9 | readonly class JsonRPCResponse implements Stringable
10 | {
11 |     public function __construct(
12 |         private JsonRPCRequest $rpcRequest,
13 |         private mixed $content,
14 |     ) {}
15 | 
16 |     public function __toString(): string
17 |     {
18 |         return json_encode([
19 |             'id' => $this->rpcRequest->requestId,
20 |             'jsonrpc' => '2.0',
21 |             'method' => $this->rpcRequest->method,
22 |             'result' => $this->content,
23 |         ]);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/JsonSchemableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use JsonSerializable;
 8 | use stdClass;
 9 | 
10 | /**
11 |  * @psalm-type PJsonSchema = stdClass|array{
12 |  *     anyOf?: list<array>,
13 |  *     const?: int|float|non-empty-string,
14 |  *     default?: mixed,
15 |  *     type?: non-empty-string|list<non-empty-string>,
16 |  *     ...
17 |  * }
18 |  */
19 | interface JsonSchemableInterface extends JsonSerializable
20 | {
21 |     /**
22 |      * @return PJsonSchema
23 |      */
24 |     public function toJsonSchema(): array|object;
25 | }
26 | 


--------------------------------------------------------------------------------
/src/LlamaCppClientInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Generator;
 8 | 
 9 | interface LlamaCppClientInterface
10 | {
11 |     public function generateCompletion(LlamaCppCompletionRequest $request): LlamaCppCompletionIterator;
12 | 
13 |     public function generateEmbedding(LlamaCppEmbeddingRequest $request): LlamaCppEmbedding;
14 | 
15 |     /**
16 |      * @return Generator<LlamaCppInfill>
17 |      */
18 |     public function generateInfill(LlamaCppInfillRequest $request): Generator;
19 | 
20 |     public function getHealth(): LlamaCppHealthStatus;
21 | }
22 | 


--------------------------------------------------------------------------------
/src/LlamaCppClientResponseChunk.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class LlamaCppClientResponseChunk
 8 | {
 9 |     public function __construct(
10 |         public ObservableTaskStatus $status,
11 |         public string $chunk,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/LlamaCppEmbedding.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class LlamaCppEmbedding
 8 | {
 9 |     /**
10 |      * @param list<float> $embedding
11 |      */
12 |     public function __construct(
13 |         public array $embedding,
14 |     ) {}
15 | }
16 | 


--------------------------------------------------------------------------------
/src/LlamaCppEmbeddingRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use JsonSerializable;
 8 | 
 9 | readonly class LlamaCppEmbeddingRequest implements JsonSerializable
10 | {
11 |     /**
12 |      * @param non-empty-string $content
13 |      */
14 |     public function __construct(
15 |         public string $content,
16 |     ) {}
17 | 
18 |     public function jsonSerialize(): array
19 |     {
20 |         return [
21 |             'content' => $this->content,
22 |         ];
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/LlamaCppExtractSubjectResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @psalm-suppress PossiblyUnusedProperty used in applications
 9 |  */
10 | readonly class LlamaCppExtractSubjectResult
11 | {
12 |     public function __construct(
13 |         public string $content,
14 |         public string $input,
15 |         public bool $isMatched,
16 |         public bool $isFailed,
17 |         public string $topic,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/LlamaCppExtractWhenInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Generator;
 8 | 
 9 | interface LlamaCppExtractWhenInterface
10 | {
11 |     public function extract(
12 |         string $input,
13 |         string $condition,
14 |         LlmPersonaInterface $persona,
15 |     ): LlamaCppExtractWhenResult;
16 | 
17 |     /**
18 |      * @return Generator<mixed,LlmCompletionProgressInterface,mixed,LlamaCppExtractWhenResult>
19 |      */
20 |     public function extractWithProgress(
21 |         string $input,
22 |         string $condition,
23 |         LlmPersonaInterface $persona,
24 |     ): Generator;
25 | }
26 | 


--------------------------------------------------------------------------------
/src/LlamaCppExtractWhenResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @psalm-suppress PossiblyUnusedProperty used in applications
 9 |  */
10 | readonly class LlamaCppExtractWhenResult
11 | {
12 |     public function __construct(
13 |         public string $condition,
14 |         public string $input,
15 |         public bool $isFailed,
16 |         public bool $isMatched,
17 |         public YesNoMaybe $result,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/LlamaCppExtractYesNoMaybeResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @psalm-suppress PossiblyUnusedProperty used in applications
 9 |  */
10 | readonly class LlamaCppExtractYesNoMaybeResult
11 | {
12 |     public function __construct(
13 |         public string $input,
14 |         public bool $isFailed,
15 |         public ?YesNoMaybe $result,
16 |     ) {}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/LlamaCppHealthStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum LlamaCppHealthStatus: string
 8 | {
 9 |     case Error = 'error';
10 |     case LoadingModel = 'loading model';
11 |     case Ok = 'ok';
12 | }
13 | 


--------------------------------------------------------------------------------
/src/LlamaCppInfill.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Stringable;
 8 | 
 9 | /**
10 |  * @psalm-suppress PossiblyUnusedProperty used in commands
11 |  */
12 | readonly class LlamaCppInfill implements Stringable
13 | {
14 |     public function __construct(
15 |         public string $after,
16 |         public string $before,
17 |         public string $content,
18 |     ) {}
19 | 
20 |     public function __toString(): string
21 |     {
22 |         return $this->content;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/LlamaCppInfillRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use JsonSerializable;
 8 | 
 9 | readonly class LlamaCppInfillRequest implements JsonSerializable
10 | {
11 |     public function __construct(
12 |         public string $after,
13 |         public string $before,
14 |     ) {}
15 | 
16 |     public function jsonSerialize(): array
17 |     {
18 |         return [
19 |             'infill_prefix' => $this->before,
20 |             'infill_suffix' => $this->after,
21 |         ];
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/LlamaCppLinkBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | 
 9 | #[Singleton]
10 | readonly class LlamaCppLinkBuilder
11 | {
12 |     public function __construct(
13 |         private LlamaCppConfiguration $ollamaConfiguration,
14 |     ) {}
15 | 
16 |     public function build(string $path): string
17 |     {
18 |         return sprintf(
19 |             '%s://%s:%d%s',
20 |             $this->ollamaConfiguration->scheme,
21 |             $this->ollamaConfiguration->host,
22 |             $this->ollamaConfiguration->port,
23 |             $path,
24 |         );
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/LlmChatHistory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class LlmChatHistory
 8 | {
 9 |     /**
10 |      * @param array<LlmChatMessage> $messages
11 |      */
12 |     public function __construct(
13 |         public array $messages,
14 |     ) {}
15 | }
16 | 


--------------------------------------------------------------------------------
/src/LlmChatHistoryRenderer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | 
 9 | #[Singleton]
10 | readonly class LlmChatHistoryRenderer
11 | {
12 |     public function __construct(
13 |         private LlmChatMessageRendererInterface $llmChatMessageRenderer,
14 |     ) {}
15 | 
16 |     public function renderLlmChatHistory(
17 |         LlmChatHistory $llmChatHistory,
18 |     ): string {
19 |         $ret = '';
20 | 
21 |         foreach ($llmChatHistory->messages as $message) {
22 |             $ret .= $this->llmChatMessageRenderer->renderLlmChatMessage($message)."\n";
23 |         }
24 | 
25 |         return $ret;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/LlmChatMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class LlmChatMessage
 8 | {
 9 |     public function __construct(
10 |         public string $actor,
11 |         public string $message,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/LlmChatMessageRenderer.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class LlmChatMessageRenderer implements LlmChatMessageRendererInterface {}
8 | 


--------------------------------------------------------------------------------
/src/LlmChatMessageRenderer/ChatMLMessageRenderer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\LlmChatMessageRenderer;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\LlmChatMessage;
 9 | use Distantmagic\Resonance\LlmChatMessageRenderer;
10 | 
11 | #[Singleton]
12 | readonly class ChatMLMessageRenderer extends LlmChatMessageRenderer
13 | {
14 |     public function renderLlmChatMessage(LlmChatMessage $llmChatMessage): string
15 |     {
16 |         return <<<FORMATTED
17 |         <|im_start|>{$llmChatMessage->actor}
18 |         {$llmChatMessage->message}<|im_end|>
19 |         FORMATTED;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/LlmChatMessageRenderer/GemmaInstructMessageRenderer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\LlmChatMessageRenderer;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\LlmChatMessage;
 9 | use Distantmagic\Resonance\LlmChatMessageRenderer;
10 | 
11 | #[Singleton]
12 | readonly class GemmaInstructMessageRenderer extends LlmChatMessageRenderer
13 | {
14 |     public function renderLlmChatMessage(LlmChatMessage $llmChatMessage): string
15 |     {
16 |         return <<<FORMATTED
17 |         <start_of_turn>{$llmChatMessage->actor}
18 |         {$llmChatMessage->message}<end_of_turn>
19 |         FORMATTED;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/LlmChatMessageRenderer/MistralInstructMessageRenderer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\LlmChatMessageRenderer;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\LlmChatMessage;
 9 | use Distantmagic\Resonance\LlmChatMessageRenderer;
10 | 
11 | #[Singleton]
12 | readonly class MistralInstructMessageRenderer extends LlmChatMessageRenderer
13 | {
14 |     public function renderLlmChatMessage(LlmChatMessage $llmChatMessage): string
15 |     {
16 |         return <<<FORMATTED
17 |         [INST]{$llmChatMessage->message}[/INST]
18 |         FORMATTED;
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/LlmChatMessageRenderer/Phi2QuestionRenderer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\LlmChatMessageRenderer;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\LlmChatMessage;
 9 | use Distantmagic\Resonance\LlmChatMessageRenderer;
10 | 
11 | #[Singleton]
12 | readonly class Phi2QuestionRenderer extends LlmChatMessageRenderer
13 | {
14 |     public function renderLlmChatMessage(LlmChatMessage $llmChatMessage): string
15 |     {
16 |         return <<<FORMATTED
17 |         Question: $llmChatMessage->message
18 |         Answer:
19 |         FORMATTED;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/LlmChatMessageRendererInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface LlmChatMessageRendererInterface
 8 | {
 9 |     public function renderLlmChatMessage(LlmChatMessage $llmChatMessage): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/LlmChatTemplateType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum LlmChatTemplateType: string
 8 | {
 9 |     use EnumValuesTrait;
10 | 
11 |     case ChatML = 'chatml';
12 |     case MistralInstruct = 'mistral_instruct';
13 | }
14 | 


--------------------------------------------------------------------------------
/src/LlmCompletionProgress.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class LlmCompletionProgress implements LlmCompletionProgressInterface
 8 | {
 9 |     public function __construct(
10 |         private string $category,
11 |         private bool $shouldNotify,
12 |     ) {}
13 | 
14 |     public function getCategory(): string
15 |     {
16 |         return $this->category;
17 |     }
18 | 
19 |     public function shouldNotify(): bool
20 |     {
21 |         return $this->shouldNotify;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/LlmCompletionProgressInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface LlmCompletionProgressInterface
 8 | {
 9 |     public function getCategory(): string;
10 | 
11 |     public function shouldNotify(): bool;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/LlmCompletionTokenInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface LlmCompletionTokenInterface
 8 | {
 9 |     public function getContent(): string;
10 | 
11 |     public function isFailed(): bool;
12 | 
13 |     public function isLastToken(): bool;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/LlmPersona.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class LlmPersona implements LlmPersonaInterface {}
8 | 


--------------------------------------------------------------------------------
/src/LlmPersona/HelpfulAssistant.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\LlmPersona;
 6 | 
 7 | use Distantmagic\Resonance\LlmPersona;
 8 | 
 9 | readonly class HelpfulAssistant extends LlmPersona
10 | {
11 |     private string $personaDescription;
12 | 
13 |     public function __construct()
14 |     {
15 |         $this->personaDescription = <<<'PERSONA'
16 |         You are a helpful assistant.
17 |         PERSONA;
18 |     }
19 | 
20 |     public function getPersonaDescription(): string
21 |     {
22 |         return $this->personaDescription;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/LlmPersonaInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface LlmPersonaInterface
 8 | {
 9 |     public function getPersonaDescription(): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/LlmPrompt.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | abstract readonly class LlmPrompt
 8 | {
 9 |     abstract public function getPromptContent(): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/LoggableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface LoggableInterface
 8 | {
 9 |     public function shouldLog(): bool;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/MailBounceReportInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Symfony\Component\Mime\Address;
 8 | 
 9 | interface MailBounceReportInterface
10 | {
11 |     /**
12 |      * @return null|non-empty-string
13 |      */
14 |     public function getDiagnosticCode(): ?string;
15 | 
16 |     /**
17 |      * @return null|non-empty-string
18 |      */
19 |     public function getNotification(): ?string;
20 | 
21 |     public function getRecipient(): Address;
22 | 
23 |     public function getSender(): ?Address;
24 | 
25 |     /**
26 |      * @return null|non-empty-string
27 |      */
28 |     public function getStatus(): ?string;
29 | }
30 | 


--------------------------------------------------------------------------------
/src/MailerConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class MailerConfiguration
10 | {
11 |     /**
12 |      * @var Map<non-empty-string,MailerTransportConfiguration>
13 |      */
14 |     public Map $transportConfiguration;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->transportConfiguration = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/MailerRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class MailerRepository
10 | {
11 |     /**
12 |      * @var Map<non-empty-string,Mailer>
13 |      */
14 |     public Map $mailer;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->mailer = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/NameableEnumTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | trait NameableEnumTrait
 8 | {
 9 |     /**
10 |      * @return non-empty-string
11 |      */
12 |     public function getName(): string
13 |     {
14 |         return $this->name;
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/NameableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface NameableInterface
 8 | {
 9 |     /**
10 |      * @return non-empty-string
11 |      */
12 |     public function getName(): string;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/OAuth2AuthorizedUser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\OAuth2\Server\Entities\UserEntityInterface;
 8 | use Stringable;
 9 | 
10 | readonly class OAuth2AuthorizedUser implements UserEntityInterface
11 | {
12 |     public function __construct(private int|string|Stringable $identifier) {}
13 | 
14 |     public function getIdentifier(): int|string|Stringable
15 |     {
16 |         return $this->identifier;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/OAuth2Claim.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Set;
 8 | use League\OAuth2\Server\Entities\AccessTokenEntityInterface;
 9 | use League\OAuth2\Server\Entities\ClientEntityInterface;
10 | 
11 | /**
12 |  * @psalm-suppress PossiblyUnusedProperty used in applications
13 |  */
14 | readonly class OAuth2Claim
15 | {
16 |     /**
17 |      * @param Set<OAuth2ScopeInterface> $scopes
18 |      */
19 |     public function __construct(
20 |         public AccessTokenEntityInterface $accessToken,
21 |         public ClientEntityInterface $client,
22 |         public UserInterface $user,
23 |         public Set $scopes,
24 |     ) {}
25 | }
26 | 


--------------------------------------------------------------------------------
/src/OAuth2Endpoint.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum OAuth2Endpoint
 8 | {
 9 |     case AccessToken;
10 |     case AuthenticatedPage;
11 |     case Authorization;
12 |     case ClientScopeConsentForm;
13 |     case LoginForm;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/OAuth2Entity.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\OAuth2\Server\Entities\Traits\EntityTrait;
 8 | 
 9 | abstract class OAuth2Entity
10 | {
11 |     use EntityTrait;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/OAuth2Entity/RefreshToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\OAuth2Entity;
 6 | 
 7 | use Distantmagic\Resonance\OAuth2Entity;
 8 | use League\OAuth2\Server\Entities\RefreshTokenEntityInterface;
 9 | use League\OAuth2\Server\Entities\Traits\RefreshTokenTrait;
10 | 
11 | class RefreshToken extends OAuth2Entity implements RefreshTokenEntityInterface
12 | {
13 |     use RefreshTokenTrait;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/OAuth2Entity/Scope.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\OAuth2Entity;
 6 | 
 7 | use Distantmagic\Resonance\OAuth2Entity;
 8 | use League\OAuth2\Server\Entities\ScopeEntityInterface;
 9 | use ReturnTypeWillChange;
10 | 
11 | class Scope extends OAuth2Entity implements ScopeEntityInterface
12 | {
13 |     #[ReturnTypeWillChange]
14 |     public function jsonSerialize()
15 |     {
16 |         return $this->getIdentifier();
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/OAuth2Entity/Token.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\OAuth2Entity;
 6 | 
 7 | use Distantmagic\Resonance\OAuth2Entity;
 8 | use League\OAuth2\Server\Entities\TokenInterface;
 9 | use League\OAuth2\Server\Entities\Traits\TokenEntityTrait;
10 | 
11 | abstract class Token extends OAuth2Entity implements TokenInterface
12 | {
13 |     use TokenEntityTrait;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/OAuth2Entity/Token/AccessToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\OAuth2Entity\Token;
 6 | 
 7 | use Distantmagic\Resonance\OAuth2Entity\Token;
 8 | use League\OAuth2\Server\Entities\AccessTokenEntityInterface;
 9 | use League\OAuth2\Server\Entities\Traits\AccessTokenTrait;
10 | 
11 | class AccessToken extends Token implements AccessTokenEntityInterface
12 | {
13 |     use AccessTokenTrait;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/OAuth2Entity/Token/AuthCode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\OAuth2Entity\Token;
 6 | 
 7 | use Distantmagic\Resonance\OAuth2Entity\Token;
 8 | use League\OAuth2\Server\Entities\AuthCodeEntityInterface;
 9 | use League\OAuth2\Server\Entities\Traits\AuthCodeTrait;
10 | 
11 | class AuthCode extends Token implements AuthCodeEntityInterface
12 | {
13 |     use AuthCodeTrait;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/OAuth2Entity/User.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\OAuth2Entity;
 6 | 
 7 | use Distantmagic\Resonance\OAuth2Entity;
 8 | use League\OAuth2\Server\Entities\UserEntityInterface;
 9 | 
10 | class User extends OAuth2Entity implements UserEntityInterface {}
11 | 


--------------------------------------------------------------------------------
/src/OAuth2Grant.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use DateInterval;
 8 | use League\OAuth2\Server\Grant\GrantTypeInterface;
 9 | 
10 | readonly class OAuth2Grant
11 | {
12 |     public function __construct(
13 |         public GrantTypeInterface $grantType,
14 |         public ?DateInterval $accessTokenTtl = null,
15 |     ) {}
16 | }
17 | 


--------------------------------------------------------------------------------
/src/OAuth2GrantAwareClient.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\OAuth2\Server\Entities\ClientEntityInterface;
 8 | 
 9 | interface OAuth2GrantAwareClient extends ClientEntityInterface
10 | {
11 |     public function isGrantTypeAccepted(string $grantType): bool;
12 | 
13 |     public function isGrantTypeRequired(): bool;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/OAuth2GrantCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Set;
 8 | 
 9 | readonly class OAuth2GrantCollection
10 | {
11 |     /**
12 |      * @var Set<OAuth2Grant>
13 |      */
14 |     public Set $oAuth2Grants;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->oAuth2Grants = new Set();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/OAuth2GrantProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use DateInterval;
 8 | 
 9 | abstract readonly class OAuth2GrantProvider implements OAuth2GrantProviderInterface
10 | {
11 |     public function getAccessTokenTTL(): DateInterval
12 |     {
13 |         return new DateInterval('PT1H');
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/src/OAuth2GrantProviderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use DateInterval;
 8 | use League\OAuth2\Server\Grant\GrantTypeInterface;
 9 | 
10 | interface OAuth2GrantProviderInterface
11 | {
12 |     public function getAccessTokenTTL(): DateInterval;
13 | 
14 |     public function provideGrant(): GrantTypeInterface;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/OAuth2Scope.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | abstract readonly class OAuth2Scope implements OAuth2ScopeInterface
10 | {
11 |     /**
12 |      * @param Map<string,string> $parameters
13 |      */
14 |     public function __construct(public Map $parameters) {}
15 | 
16 |     public function jsonSerialize(): mixed
17 |     {
18 |         return $this->getIdentifier();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/OAuth2ScopeCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\ProvidesOAuth2Scope;
 8 | use Ds\Map;
 9 | 
10 | final readonly class OAuth2ScopeCollection
11 | {
12 |     /**
13 |      * @var Map<ProvidesOAuth2Scope,class-string<OAuth2ScopeInterface>> $scopes
14 |      */
15 |     public Map $scopes;
16 | 
17 |     public function __construct()
18 |     {
19 |         $this->scopes = new Map();
20 |     }
21 | 
22 |     /**
23 |      * @param class-string<OAuth2ScopeInterface> $scopeClass
24 |      */
25 |     public function addScope(ProvidesOAuth2Scope $attribute, string $scopeClass): void
26 |     {
27 |         $this->scopes->put($attribute, $scopeClass);
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/OAuth2ScopeInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\OAuth2\Server\Entities\ScopeEntityInterface;
 8 | 
 9 | interface OAuth2ScopeInterface extends ScopeEntityInterface
10 | {
11 |     public function getIdentifier(): string;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/OAuth2ScopePatternChunk.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class OAuth2ScopePatternChunk
 8 | {
 9 |     public string $basename;
10 | 
11 |     public function __construct(public string $chunk)
12 |     {
13 |         $this->basename = trim($chunk, '{}');
14 |     }
15 | 
16 |     public function isVariable(): bool
17 |     {
18 |         return str_starts_with($this->chunk, '{') && str_ends_with($this->chunk, '}');
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/OAuth2ScopePatternMatch.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class OAuth2ScopePatternMatch
10 | {
11 |     /**
12 |      * @var Map<string,string> $parameters
13 |      */
14 |     public Map $parameters;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->parameters = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/OAuth2SecretAwareClient.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\OAuth2\Server\Entities\ClientEntityInterface;
 8 | 
 9 | interface OAuth2SecretAwareClient extends ClientEntityInterface
10 | {
11 |     public function isSecretRequired(): bool;
12 | 
13 |     public function isSecretValid(string $secret): bool;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/ObjectType/RootFieldType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\ObjectType;
 6 | 
 7 | use Distantmagic\Resonance\GraphQLRootFieldType;
 8 | use Distantmagic\Resonance\GraphQLSchemaRootFieldInterface;
 9 | use GraphQL\Type\Definition\ObjectType;
10 | 
11 | final class RootFieldType extends ObjectType implements GraphQLSchemaRootFieldInterface
12 | {
13 |     public function __construct(
14 |         GraphQLRootFieldType $type,
15 |         array $fields,
16 |     ) {
17 |         parent::__construct([
18 |             'name' => $type->name,
19 |             'fields' => $fields,
20 |         ]);
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/ObservableTaskCategory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum ObservableTaskCategory: string
 8 | {
 9 |     case LlamaCpp = 'llama_cpp';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/ObservableTaskConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use SensitiveParameter;
 8 | 
 9 | readonly class ObservableTaskConfiguration
10 | {
11 |     /**
12 |      * @psalm-taint-source system_secret $maxTasks
13 |      */
14 |     public function __construct(
15 |         #[SensitiveParameter]
16 |         public int $maxTasks,
17 |         public int $serializedStatusSize,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/ObservableTaskInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use IteratorAggregate;
 8 | 
 9 | /**
10 |  * @template-extends IteratorAggregate<ObservableTaskStatusUpdate>
11 |  */
12 | interface ObservableTaskInterface extends IteratorAggregate
13 | {
14 |     public function getCategory(): string;
15 | 
16 |     public function getName(): string;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/ObservableTaskStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum ObservableTaskStatus: string
 8 | {
 9 |     case Cancelled = 'cancelled';
10 |     case Failed = 'failed';
11 |     case Finished = 'finished';
12 |     case Pending = 'pending';
13 |     case Running = 'running';
14 |     case TimedOut = 'timed_out';
15 | 
16 |     public function isFinal(): bool
17 |     {
18 |         return match ($this) {
19 |             ObservableTaskStatus::Cancelled,
20 |             ObservableTaskStatus::Failed,
21 |             ObservableTaskStatus::Finished,
22 |             ObservableTaskStatus::TimedOut => true,
23 |             default => false,
24 |         };
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/ObservableTaskStatusReporter.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | readonly class ObservableTaskStatusReporter {}
8 | 


--------------------------------------------------------------------------------
/src/ObservableTaskStatusUpdate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use JsonSerializable;
 8 | 
 9 | /**
10 |  * @template TData
11 |  */
12 | readonly class ObservableTaskStatusUpdate implements JsonSerializable
13 | {
14 |     /**
15 |      * @param TData $data
16 |      */
17 |     public function __construct(
18 |         public ObservableTaskStatus $status,
19 |         public mixed $data,
20 |     ) {}
21 | 
22 |     public function jsonSerialize(): array
23 |     {
24 |         return [
25 |             'status' => $this->status->value,
26 |             'data' => $this->data,
27 |         ];
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/ObservableTaskTableRow.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use DateTimeImmutable;
 8 | 
 9 | /**
10 |  * @psalm-suppress PossiblyUnusedProperty it's used in the templates
11 |  */
12 | readonly class ObservableTaskTableRow
13 | {
14 |     public function __construct(
15 |         public ObservableTaskStatusUpdate $observableTaskStatusUpdate,
16 |         public string $category,
17 |         public string $name,
18 |         public DateTimeImmutable $modifiedAt,
19 |     ) {}
20 | }
21 | 


--------------------------------------------------------------------------------
/src/PDOException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use RuntimeException;
 8 | use Throwable;
 9 | 
10 | class PDOException extends RuntimeException
11 | {
12 |     /**
13 |      * @param array{0: null|string, 1: null|int, 2: null|string, 3?: mixed, 4?: mixed}|mixed $errorInfo
14 |      */
15 |     public function __construct(mixed $errorInfo, ?Throwable $previous = null)
16 |     {
17 |         parent::__construct(print_r($errorInfo, true), 0, $previous);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/PHPFileReflectionFunctionAttribute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use ReflectionFunction;
 8 | 
 9 | /**
10 |  * @template TAttribute of object
11 |  */
12 | readonly class PHPFileReflectionFunctionAttribute implements ReflectionAttributeInterface
13 | {
14 |     /**
15 |      * @param TAttribute $attribute
16 |      */
17 |     public function __construct(
18 |         public ReflectionFunction $reflectionFunction,
19 |         public object $attribute,
20 |     ) {}
21 | 
22 |     public function getReflectionAttributeManager(): ReflectionAttributeManager
23 |     {
24 |         return new ReflectionAttributeManager($this->reflectionFunction);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/PromptSubjectRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @psalm-suppress PossiblyUnusedProperty used in applications
 9 |  */
10 | readonly class PromptSubjectRequest
11 | {
12 |     public function __construct(
13 |         public ?AuthenticatedUser $authenticatedUser,
14 |         public string $prompt,
15 |     ) {}
16 | }
17 | 


--------------------------------------------------------------------------------
/src/PromptSubjectResponderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface PromptSubjectResponderInterface
 8 | {
 9 |     public function respondToPromptSubject(
10 |         PromptSubjectRequest $request,
11 |         PromptSubjectResponse $response,
12 |     ): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/PromptSubjectResponseChunk.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class PromptSubjectResponseChunk
 8 | {
 9 |     public function __construct(
10 |         public bool $isFailed,
11 |         public bool $isLastChunk,
12 |         public bool $isTimeout,
13 |         public mixed $payload,
14 |     ) {}
15 | }
16 | 


--------------------------------------------------------------------------------
/src/PsrMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\MessageInterface;
 8 | 
 9 | abstract readonly class PsrMessage implements MessageInterface {}
10 | 


--------------------------------------------------------------------------------
/src/RedisConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class RedisConfiguration
10 | {
11 |     /**
12 |      * @var Map<string,RedisConnectionPoolConfiguration>
13 |      */
14 |     public Map $connectionPoolConfiguration;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->connectionPoolConfiguration = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/ReflectionAttributeInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface ReflectionAttributeInterface
 8 | {
 9 |     public function getReflectionAttributeManager(): ReflectionAttributeManager;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/RegisterableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface RegisterableInterface
 8 | {
 9 |     public function shouldRegister(): bool;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/RequestDataSource.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum RequestDataSource: string
 8 | {
 9 |     case Get = 'get';
10 |     case Post = 'post';
11 | }
12 | 


--------------------------------------------------------------------------------
/src/RequestMethod.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum RequestMethod: string
 8 | {
 9 |     case CONNECT = 'CONNECT';
10 |     case DELETE = 'DELETE';
11 |     case GET = 'GET';
12 |     case HEAD = 'HEAD';
13 |     case OPTIONS = 'OPTIONS';
14 |     case PATCH = 'PATCH';
15 |     case POST = 'POST';
16 |     case PURGE = 'PURGE';
17 |     case PUT = 'PUT';
18 |     case TRACE = 'TRACE';
19 | }
20 | 


--------------------------------------------------------------------------------
/src/RespondsToHttpAttributeClassCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\RespondsToHttp;
 8 | use Ds\Map;
 9 | 
10 | readonly class RespondsToHttpAttributeClassCollection
11 | {
12 |     /**
13 |      * @var Map<class-string<HttpResponderInterface>, PHPFileReflectionClassAttribute<HttpResponderInterface,RespondsToHttp>> $attributes
14 |      */
15 |     public Map $attributes;
16 | 
17 |     public function __construct()
18 |     {
19 |         $this->attributes = new Map();
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/RespondsToHttpAttributeRoute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\RespondsToHttp;
 8 | use Symfony\Component\Routing\Route;
 9 | 
10 | readonly class RespondsToHttpAttributeRoute
11 | {
12 |     public Route $symfonyRoute;
13 | 
14 |     public function __construct(RespondsToHttp $attribute)
15 |     {
16 |         $this->symfonyRoute = new Route($attribute->pattern);
17 |         $this->symfonyRoute->setMethods($attribute->method->value);
18 | 
19 |         if ($attribute->requirements) {
20 |             $this->symfonyRoute->setRequirements($attribute->requirements);
21 |         }
22 | 
23 |         $this->symfonyRoute->compile();
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/RespondsToPromptSubjectAttributeCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\RespondsToPromptSubject;
 8 | use Ds\Set;
 9 | 
10 | readonly class RespondsToPromptSubjectAttributeCollection
11 | {
12 |     /**
13 |      * @var Set<RespondsToPromptSubject> $attributes
14 |      */
15 |     public Set $attributes;
16 | 
17 |     public function __construct()
18 |     {
19 |         $this->attributes = new Set();
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/SQLiteVSSConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use SensitiveParameter;
 8 | 
 9 | readonly class SQLiteVSSConfiguration
10 | {
11 |     /**
12 |      * @param non-empty-string $extensionVector0
13 |      * @param non-empty-string $extensionVss0
14 |      */
15 |     public function __construct(
16 |         #[SensitiveParameter]
17 |         public string $extensionVector0,
18 |         #[SensitiveParameter]
19 |         public string $extensionVss0,
20 |     ) {}
21 | }
22 | 


--------------------------------------------------------------------------------
/src/SanitizedMarkdownParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use HTMLPurifier;
 9 | 
10 | #[Singleton]
11 | final readonly class SanitizedMarkdownParser
12 | {
13 |     private MarkdownParser $markdownParser;
14 | 
15 |     public function __construct(
16 |         private readonly HTMLPurifier $purifier,
17 |     ) {
18 |         $this->markdownParser = new MarkdownParser();
19 |     }
20 | 
21 |     public function toHtml(string $content): string
22 |     {
23 |         $text = $this->markdownParser->toHtml($content);
24 | 
25 |         return $this->purifier->purify($text);
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/SecureIdentifierGenerator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | 
 9 | #[Singleton]
10 | readonly class SecureIdentifierGenerator
11 | {
12 |     /**
13 |      * @param int<1,max> $byteLength
14 |      */
15 |     public function generate(int $byteLength = 32): string
16 |     {
17 |         return bin2hex(random_bytes($byteLength));
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Serializer.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class Serializer implements SerializerInterface {}
8 | 


--------------------------------------------------------------------------------
/src/Serializer/Igbinary.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Serializer;
 6 | 
 7 | use Distantmagic\Resonance\Serializer;
 8 | 
 9 | readonly class Igbinary extends Serializer
10 | {
11 |     public function serialize(mixed $data): string
12 |     {
13 |         return igbinary_serialize($data);
14 |     }
15 | 
16 |     public function unserialize(string $data): mixed
17 |     {
18 |         return igbinary_unserialize($data);
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Serializer/Vanilla.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\Serializer;
 6 | 
 7 | use Distantmagic\Resonance\Serializer;
 8 | 
 9 | readonly class Vanilla extends Serializer
10 | {
11 |     public function serialize(mixed $data): string
12 |     {
13 |         return serialize($data);
14 |     }
15 | 
16 |     public function unserialize(string $data): mixed
17 |     {
18 |         return unserialize($data);
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/SerializerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface SerializerInterface
 8 | {
 9 |     public function serialize(mixed $data): string;
10 | 
11 |     public function unserialize(string $data): mixed;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/ServerPipeMessage.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | readonly class ServerPipeMessage implements ServerPipeMessageInterface {}
8 | 


--------------------------------------------------------------------------------
/src/ServerPipeMessage/CloseWebSocketConnection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\ServerPipeMessage;
 6 | 
 7 | use Distantmagic\Resonance\ServerPipeMessage;
 8 | 
 9 | readonly class CloseWebSocketConnection extends ServerPipeMessage
10 | {
11 |     public function __construct(public int $fd) {}
12 | }
13 | 


--------------------------------------------------------------------------------
/src/ServerPipeMessageHandlerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TPipeMessage of ServerPipeMessageInterface
 9 |  */
10 | interface ServerPipeMessageHandlerInterface
11 | {
12 |     /**
13 |      * I wish PHP had generics.
14 |      *
15 |      * @param TPipeMessage $serverPipeMessage
16 |      */
17 |     public function handleServerPipeMessage(
18 |         ServerPipeMessageInterface $serverPipeMessage,
19 |     ): void;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/ServerPipeMessageInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface ServerPipeMessageInterface {}
8 | 


--------------------------------------------------------------------------------
/src/ServerTask.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class ServerTask {}
8 | 


--------------------------------------------------------------------------------
/src/ServerTask/SendEmailMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\ServerTask;
 6 | 
 7 | use Symfony\Component\Mime\Message;
 8 | 
 9 | readonly class SendEmailMessage
10 | {
11 |     /**
12 |      * @param non-empty-string $transportName
13 |      */
14 |     public function __construct(
15 |         public string $transportName,
16 |         public Message $message,
17 |     ) {}
18 | }
19 | 


--------------------------------------------------------------------------------
/src/ServerTaskHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TTask of object
 9 |  *
10 |  * @template-implements ServerTaskHandlerInterface<TTask>
11 |  */
12 | abstract readonly class ServerTaskHandler implements ServerTaskHandlerInterface {}
13 | 


--------------------------------------------------------------------------------
/src/ServerTaskHandlerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TTask of object
 9 |  */
10 | interface ServerTaskHandlerInterface
11 | {
12 |     /**
13 |      * I wish PHP had generics.
14 |      *
15 |      * @param TTask $serverTask
16 |      */
17 |     public function handleServerTask(object $serverTask): void;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/SessionConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class SessionConfiguration
 8 | {
 9 |     /**
10 |      * @param non-empty-string      $cookieName
11 |      * @param 'lax'|'none'|'strict' $cookieSameSite
12 |      */
13 |     public function __construct(
14 |         public string $cookieName,
15 |         public int $cookieLifespan,
16 |         public string $cookieSameSite,
17 |         public string $redisConnectionPool,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/SideEffectProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | abstract readonly class SideEffectProvider implements SideEffectProviderInterface
 8 | {
 9 |     public function shouldRegister(): bool
10 |     {
11 |         return true;
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/src/SideEffectProviderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface SideEffectProviderInterface extends RegisterableInterface
 8 | {
 9 |     public function provideSideEffect(): void;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/SingletonAttribute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TSingleton of object
 9 |  * @template TAttribute of Attribute
10 |  */
11 | readonly class SingletonAttribute
12 | {
13 |     /**
14 |      * @param TSingleton $singleton
15 |      * @param TAttribute $attribute
16 |      */
17 |     public function __construct(
18 |         public object $singleton,
19 |         public Attribute $attribute,
20 |     ) {}
21 | }
22 | 


--------------------------------------------------------------------------------
/src/SingletonCollectionInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface SingletonCollectionInterface {}
8 | 


--------------------------------------------------------------------------------
/src/SingletonContainerException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use LogicException;
 8 | use Psr\Container\ContainerExceptionInterface;
 9 | 
10 | class SingletonContainerException extends LogicException implements ContainerExceptionInterface {}
11 | 


--------------------------------------------------------------------------------
/src/SingletonContainerException/NotFoundException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\SingletonContainerException;
 6 | 
 7 | use Distantmagic\Resonance\SingletonContainerException;
 8 | use Psr\Container\NotFoundExceptionInterface;
 9 | 
10 | class NotFoundException extends SingletonContainerException implements NotFoundExceptionInterface {}
11 | 


--------------------------------------------------------------------------------
/src/SingletonFunctionParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use ReflectionParameter;
 8 | 
 9 | readonly class SingletonFunctionParameter
10 | {
11 |     /**
12 |      * @param class-string $className
13 |      */
14 |     public function __construct(
15 |         public string $className,
16 |         public ReflectionParameter $reflectionParameter,
17 |     ) {}
18 | }
19 | 


--------------------------------------------------------------------------------
/src/SingletonProvider/HyperfChannelPool.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\SingletonProvider;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | use Distantmagic\Resonance\PHPProjectFiles;
 9 | use Distantmagic\Resonance\SingletonContainer;
10 | use Distantmagic\Resonance\SingletonProvider;
11 | use Hyperf\Coroutine\Channel\Pool;
12 | 
13 | /**
14 |  * @template-extends SingletonProvider<Pool>
15 |  */
16 | #[Singleton(provides: Pool::class)]
17 | final readonly class HyperfChannelPool extends SingletonProvider
18 | {
19 |     public function provide(SingletonContainer $singletons, PHPProjectFiles $phpProjectFiles): Pool
20 |     {
21 |         return Pool::getInstance();
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/SingletonProviderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TObject of object
 9 |  */
10 | interface SingletonProviderInterface extends RegisterableInterface
11 | {
12 |     /**
13 |      * @return TObject
14 |      */
15 |     public function provide(
16 |         SingletonContainer $singletons,
17 |         PHPProjectFiles $phpProjectFiles,
18 |     ): object;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/SiteAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum SiteAction implements SiteActionInterface
 8 | {
 9 |     use NameableEnumTrait;
10 | 
11 |     case StartWebSocketJsonRPCConnection;
12 |     case UseGraphQL;
13 |     case UseOAuth2;
14 |     case ViewObservableTaskTable;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/SiteActionGate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | abstract readonly class SiteActionGate
 8 | {
 9 |     abstract public function can(?AuthenticatedUser $authenticatedUser): bool;
10 | 
11 |     public function requiresAuthenticatedUser(): bool
12 |     {
13 |         return true;
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/src/SiteActionInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface SiteActionInterface extends NameableInterface {}
8 | 


--------------------------------------------------------------------------------
/src/StaticPageAggregate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Map;
 8 | 
 9 | readonly class StaticPageAggregate
10 | {
11 |     /**
12 |      * @var Map<string,StaticPage>
13 |      */
14 |     public Map $staticPages;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->staticPages = new Map();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/StaticPageContentType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum StaticPageContentType: string
 8 | {
 9 |     use EnumValuesTrait;
10 | 
11 |     case Html = 'html';
12 |     case Markdown = 'markdown';
13 | }
14 | 


--------------------------------------------------------------------------------
/src/StaticPageFileException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use LogicException;
 8 | use Symfony\Component\Finder\SplFileInfo;
 9 | use Throwable;
10 | 
11 | class StaticPageFileException extends LogicException
12 | {
13 |     public function __construct(
14 |         SplFileInfo $splFileInfo,
15 |         string $message,
16 |         ?Throwable $previous = null,
17 |     ) {
18 |         parent::__construct(
19 |             message: sprintf(
20 |                 '%s: "%s"',
21 |                 $message,
22 |                 $splFileInfo->getPathname(),
23 |             ),
24 |             previous: $previous,
25 |         );
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/StaticPageFileException/FrontMatterValidationException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\StaticPageFileException;
 6 | 
 7 | use Distantmagic\Resonance\StaticPageFileException;
 8 | use Symfony\Component\Finder\SplFileInfo;
 9 | 
10 | class FrontMatterValidationException extends StaticPageFileException
11 | {
12 |     public function __construct(SplFileInfo $splFileInfo, string $validationErrorMessage)
13 |     {
14 |         parent::__construct(
15 |             message: 'Frant Matter is invalid: '.$validationErrorMessage,
16 |             splFileInfo: $splFileInfo,
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/StaticPageInternalLinkNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\CommonMark\Node\Inline\AbstractInline;
 8 | use League\CommonMark\Node\Inline\DelimitedInterface;
 9 | 
10 | class StaticPageInternalLinkNode extends AbstractInline implements DelimitedInterface
11 | {
12 |     public function getClosingDelimiter(): string
13 |     {
14 |         return '}}';
15 |     }
16 | 
17 |     public function getOpeningDelimiter(): string
18 |     {
19 |         return '{{';
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/StaticPageLayoutInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Generator;
 8 | 
 9 | interface StaticPageLayoutInterface extends TemplateInterface
10 | {
11 |     /**
12 |      * @return Generator<string>
13 |      */
14 |     public function renderStaticPage(StaticPage $staticPage): Generator;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/StaticPageReferenceException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use LogicException;
 8 | 
 9 | class StaticPageReferenceException extends LogicException {}
10 | 


--------------------------------------------------------------------------------
/src/StaticPageRenderingException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use LogicException;
 8 | 
 9 | class StaticPageRenderingException extends LogicException {}
10 | 


--------------------------------------------------------------------------------
/src/SwooleChannelIteratorChunk.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @template TData
 9 |  */
10 | readonly class SwooleChannelIteratorChunk
11 | {
12 |     /**
13 |      * @param TData $data
14 |      */
15 |     public function __construct(public mixed $data) {}
16 | }
17 | 


--------------------------------------------------------------------------------
/src/SwooleChannelIteratorError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class SwooleChannelIteratorError
 8 | {
 9 |     public function __construct(
10 |         public bool $isTimeout,
11 |     ) {}
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Template.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class Template implements TemplateInterface {}
8 | 


--------------------------------------------------------------------------------
/src/TemplateComponentInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface TemplateComponentInterface extends TemplateInterface {}
8 | 


--------------------------------------------------------------------------------
/src/TemplateFilters.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Distantmagic\Resonance\Attribute\Singleton;
 8 | 
 9 | #[Singleton]
10 | final readonly class TemplateFilters
11 | {
12 |     public function escape(?string $str): string
13 |     {
14 |         if (is_null($str)) {
15 |             return '';
16 |         }
17 | 
18 |         return htmlspecialchars($str, ENT_QUOTES | ENT_SUBSTITUTE);
19 |     }
20 | 
21 |     public function old(mixed $requestVars, string $field, ?string $default = null): string
22 |     {
23 |         $requestData = new HttpRequestData($requestVars);
24 | 
25 |         return $this->escape((string) $requestData->get($field, $default));
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/TemplateInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface TemplateInterface {}
8 | 


--------------------------------------------------------------------------------
/src/TestsDependencyInectionContainerTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | trait TestsDependencyInectionContainerTrait
 8 | {
 9 |     private static DependencyInjectionContainer $container;
10 | 
11 |     public static function setUpBeforeClass(): void
12 |     {
13 |         self::$container = require DM_ROOT.'/container.php';
14 |     }
15 | 
16 |     public static function tearDownAfterClass(): void
17 |     {
18 |         self::$container = null;
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/TickTimerJobAggregate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Set;
 8 | 
 9 | readonly class TickTimerJobAggregate
10 | {
11 |     /**
12 |      * @var Set<TickTimerRegisteredJob>
13 |      */
14 |     public Set $tickTimerJobs;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->tickTimerJobs = new Set();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/TickTimerJobInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface TickTimerJobInterface extends RegisterableInterface
 8 | {
 9 |     public function onTimerTick(): void;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/TickTimerRegisteredJob.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class TickTimerRegisteredJob
 8 | {
 9 |     public function __construct(
10 |         public TickTimerJobInterface $tickTimerJob,
11 |         public int $interval,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/TranslationException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | class TranslationException extends RuntimeException {}
10 | 


--------------------------------------------------------------------------------
/src/TranslationException/LanguageNotFoundException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\TranslationException;
 6 | 
 7 | use Distantmagic\Resonance\TranslationException;
 8 | 
 9 | class LanguageNotFoundException extends TranslationException
10 | {
11 |     public function __construct(string $language)
12 |     {
13 |         parent::__construct('Translations are not loaded for language: '.$language);
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/src/TranslationException/MissingTranslationParameterException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\TranslationException;
 6 | 
 7 | use Distantmagic\Resonance\TranslationException;
 8 | 
 9 | class MissingTranslationParameterException extends TranslationException
10 | {
11 |     public function __construct(string $phrase, string $missing)
12 |     {
13 |         parent::__construct("Translation parameter [{$missing}] is missing for translation string: {$phrase}");
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/src/TranslationException/PhraseNotFoundException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\TranslationException;
 6 | 
 7 | use Distantmagic\Resonance\TranslationException;
 8 | 
 9 | class PhraseNotFoundException extends TranslationException
10 | {
11 |     public function __construct(
12 |         string $language,
13 |         string $phrase,
14 |     ) {
15 |         parent::__construct('Phrase is not defined: '.$language.'/'.$phrase);
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/TranslatorConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class TranslatorConfiguration
 8 | {
 9 |     public function __construct(
10 |         public string $baseDirectory,
11 |         public string $defaultPrimaryLanguage,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/TwigFilter.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class TwigFilter implements TwigFilterInterface {}
8 | 


--------------------------------------------------------------------------------
/src/TwigFilterCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Set;
 8 | 
 9 | readonly class TwigFilterCollection
10 | {
11 |     /**
12 |      * @var Set<TwigFilterInterface>
13 |      */
14 |     public Set $twigFilters;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->twigFilters = new Set();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/TwigFilterInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface TwigFilterInterface extends NameableInterface {}
8 | 


--------------------------------------------------------------------------------
/src/TwigFunction.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class TwigFunction implements TwigFunctionInterface {}
8 | 


--------------------------------------------------------------------------------
/src/TwigFunctionCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Ds\Set;
 8 | 
 9 | readonly class TwigFunctionCollection
10 | {
11 |     /**
12 |      * @var Set<TwigFunctionInterface>
13 |      */
14 |     public Set $twigFunctions;
15 | 
16 |     public function __construct()
17 |     {
18 |         $this->twigFunctions = new Set();
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/TwigFunctionInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | interface TwigFunctionInterface extends NameableInterface {}
8 | 


--------------------------------------------------------------------------------
/src/TwigOptionalLoaderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Twig\Loader\LoaderInterface;
 8 | 
 9 | interface TwigOptionalLoaderInterface extends LoaderInterface, RegisterableInterface
10 | {
11 |     public function beforeRegister(): void;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/UserInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use League\OAuth2\Server\Entities\UserEntityInterface;
 8 | use Stringable;
 9 | 
10 | interface UserInterface extends UserEntityInterface
11 | {
12 |     public function getIdentifier(): int|string|Stringable;
13 | 
14 |     public function getRole(): UserRoleInterface;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/UserRepositoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface UserRepositoryInterface
 8 | {
 9 |     public function findUserById(int|string $userId): ?UserInterface;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/UserRoleInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface UserRoleInterface
 8 | {
 9 |     public function isAtLeast(self $other): bool;
10 | 
11 |     public function toInt(): int;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/WebSocketAuthResolution.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * Remove this suppresion after User is used somewhere (and it cetainly is
 9 |  * going to be used somewhere).
10 |  *
11 |  * @psalm-suppress PossiblyUnusedProperty
12 |  */
13 | readonly class WebSocketAuthResolution
14 | {
15 |     public function __construct(
16 |         public bool $isAuthorizedToConnect,
17 |         public ?AuthenticatedUser $authenticatedUser = null,
18 |     ) {}
19 | }
20 | 


--------------------------------------------------------------------------------
/src/WebSocketConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use SensitiveParameter;
 8 | 
 9 | readonly class WebSocketConfiguration
10 | {
11 |     /**
12 |      * @psalm-taint-source system_secret $maxConnections
13 |      */
14 |     public function __construct(
15 |         #[SensitiveParameter]
16 |         public int $maxConnections,
17 |     ) {}
18 | }
19 | 


--------------------------------------------------------------------------------
/src/WebSocketConnectionStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum WebSocketConnectionStatus
 8 | {
 9 |     case Closed;
10 |     case Open;
11 | 
12 |     public function isClosed(): bool
13 |     {
14 |         return self::Closed === $this;
15 |     }
16 | 
17 |     public function isOpen(): bool
18 |     {
19 |         return self::Open === $this;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/WebSocketJsonRPCConnectionController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | abstract readonly class WebSocketJsonRPCConnectionController implements WebSocketJsonRPCConnectionControllerInterface
 8 | {
 9 |     public function onClose(WebSocketAuthResolution $webSocketAuthResolution, WebSocketConnection $webSocketConnection): void {}
10 | }
11 | 


--------------------------------------------------------------------------------
/src/WebSocketJsonRPCConnectionControllerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | interface WebSocketJsonRPCConnectionControllerInterface
 8 | {
 9 |     public function onClose(
10 |         WebSocketAuthResolution $webSocketAuthResolution,
11 |         WebSocketConnection $webSocketConnection,
12 |     ): void;
13 | 
14 |     public function onOpen(
15 |         WebSocketAuthResolution $webSocketAuthResolution,
16 |         WebSocketConnection $webSocketConnection,
17 |     ): void;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/WebSocketProtocol.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | enum WebSocketProtocol: string
 8 | {
 9 |     case JsonRPC = 'jsonrpc';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/WebSocketProtocolController.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace Distantmagic\Resonance;
6 | 
7 | abstract readonly class WebSocketProtocolController implements WebSocketProtocolControllerInterface {}
8 | 


--------------------------------------------------------------------------------
/src/WebSocketProtocolControllerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use Psr\Http\Message\ServerRequestInterface;
 8 | use Swoole\WebSocket\Frame;
 9 | use Swoole\WebSocket\Server;
10 | 
11 | interface WebSocketProtocolControllerInterface
12 | {
13 |     public function isAuthorizedToConnect(ServerRequestInterface $request): WebSocketAuthResolution;
14 | 
15 |     public function onClose(int $fd): void;
16 | 
17 |     public function onMessage(Server $server, Frame $frame): void;
18 | 
19 |     public function onOpen(WebSocketConnection $webSocketConnection, WebSocketAuthResolution $webSocketAuthResolution): void;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/WebSocketProtocolException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | class WebSocketProtocolException extends RuntimeException {}
10 | 


--------------------------------------------------------------------------------
/src/WebSocketProtocolException/UnexpectedNotification.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\WebSocketProtocolException;
 6 | 
 7 | use Distantmagic\Resonance\JsonRPCMethodInterface;
 8 | use Distantmagic\Resonance\WebSocketProtocolException;
 9 | 
10 | class UnexpectedNotification extends WebSocketProtocolException
11 | {
12 |     public function __construct(JsonRPCMethodInterface $rpcMethod)
13 |     {
14 |         parent::__construct('RPC method must expect a notification: '.$rpcMethod->getValue());
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/WebSocketProtocolException/UnexpectedRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\WebSocketProtocolException;
 6 | 
 7 | use Distantmagic\Resonance\JsonRPCMethodInterface;
 8 | use Distantmagic\Resonance\WebSocketProtocolException;
 9 | 
10 | class UnexpectedRequest extends WebSocketProtocolException
11 | {
12 |     public function __construct(JsonRPCMethodInterface $rpcMethod)
13 |     {
14 |         parent::__construct('RPC method must not expect a response: '.$rpcMethod->getValue());
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/WebSocketResolvedProtocolController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | readonly class WebSocketResolvedProtocolController
 8 | {
 9 |     public function __construct(
10 |         public WebSocketProtocol $protocol,
11 |         public WebSocketProtocolControllerInterface $controller,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/YesNo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @see Distantmagic\Resonance\LlamaCppExtractYesNoMaybe
 9 |  */
10 | enum YesNo: string
11 | {
12 |     case No = 'no';
13 |     case Yes = 'yes';
14 | }
15 | 


--------------------------------------------------------------------------------
/src/YesNoMaybe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance;
 6 | 
 7 | /**
 8 |  * @see Distantmagic\Resonance\LlamaCppExtractYesNoMaybe
 9 |  */
10 | enum YesNoMaybe: string
11 | {
12 |     case Maybe = 'maybe';
13 |     case No = 'no';
14 |     case Yes = 'yes';
15 | 
16 |     public function isCertain(): bool
17 |     {
18 |         return self::Maybe !== $this;
19 |     }
20 | 
21 |     public function isMaybe(): bool
22 |     {
23 |         return self::Maybe === $this;
24 |     }
25 | 
26 |     public function isNo(): bool
27 |     {
28 |         return self::No === $this;
29 |     }
30 | 
31 |     public function isYes(): bool
32 |     {
33 |         return self::Yes === $this;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/helpers/coroutineMustGetContext.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\helpers;
 6 | 
 7 | use RuntimeException;
 8 | use Swoole\Coroutine;
 9 | use Swoole\Coroutine\Context;
10 | 
11 | function coroutineMustGetContext(): Context
12 | {
13 |     /**
14 |      * @var null|Context
15 |      */
16 |     $context = Coroutine::getContext();
17 | 
18 |     if (is_null($context)) {
19 |         throw new RuntimeException('Unable to get coroutine context');
20 |     }
21 | 
22 |     return $context;
23 | }
24 | 


--------------------------------------------------------------------------------
/src/helpers/coroutineMustGo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\helpers;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /**
10 |  * @param callable() $callback
11 |  */
12 | function coroutineMustGo(callable $callback): int
13 | {
14 |     $cid = go($callback);
15 | 
16 |     if (!is_int($cid)) {
17 |         throw new RuntimeException('Unable to start a coroutine');
18 |     }
19 | 
20 |     return $cid;
21 | }
22 | 


--------------------------------------------------------------------------------
/src/helpers/generatorGetReturn.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Distantmagic\Resonance\helpers;
 6 | 
 7 | use Generator;
 8 | 
 9 | /**
10 |  * @psalm-suppress UnusedForeachValue we need to consume the iterator
11 |  *
12 |  * @template TReturn
13 |  *
14 |  * @param Generator<mixed,mixed,mixed,TReturn> $generator
15 |  *
16 |  * @return TReturn
17 |  */
18 | function generatorGetReturn(Generator $generator): mixed
19 | {
20 |     /**
21 |      * @var mixed $value explicitly mixed for typechecks
22 |      */
23 |     foreach ($generator as $value) {
24 |     }
25 | 
26 |     return $generator->getReturn();
27 | }
28 | 


--------------------------------------------------------------------------------
/tmuxinator.example.yml:
--------------------------------------------------------------------------------
 1 | name: distantmagic
 2 | root: ~/workspace/distantmagic/distantmagic/resonance
 3 | 
 4 | on_project_start:
 5 |   - make node_modules
 6 |   - make vendor
 7 |   - make ssg
 8 | 
 9 | windows:
10 |   - "esbuild.watch": make esbuild.watch
11 |   - "eslint.watch": make eslint.watch
12 |   - "ssg.serve": make ssg.serve
13 |   - "ssg.watch": make ssg.watch
14 |   - "tsc.watch": make tsc.watch
15 |   - "shell": git status
16 | 


--------------------------------------------------------------------------------
/tools/php-cs-fixer/.gitignore:
--------------------------------------------------------------------------------
1 | /vendor
2 | 


--------------------------------------------------------------------------------
/tools/php-cs-fixer/composer.json:
--------------------------------------------------------------------------------
1 | {
2 |     "require": {
3 |         "friendsofphp/php-cs-fixer": "^3.21"
4 |     }
5 | }
6 | 


--------------------------------------------------------------------------------
/tools/psalm/.gitignore:
--------------------------------------------------------------------------------
1 | /vendor
2 | 


--------------------------------------------------------------------------------
/tools/psalm/composer.json:
--------------------------------------------------------------------------------
1 | {
2 |     "require": {
3 |         "vimeo/psalm": "^5.17"
4 |     }
5 | }
6 | 


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