jardissupport/contracts

Consolidated contract interfaces for all Jardis packages — Kernel, Data, Repository, DbQuery, Messaging, Validation, Workflow, and more

v1.0.1 2026-07-21 10:20 UTC

Requires

• php: >=8.2
• ext-pdo: *
• psr/container: ^2.0
• psr/event-dispatcher: ^1.0
• psr/http-client: ^1.0
• psr/log: ^3.0
• psr/simple-cache: ^3.0

Requires (Dev)

• phpstan/phpstan: 2.2.3
• squizlabs/php_codesniffer: 3.13.5

MIT

• Jardis Development

• php
• interfaces
• psr
• contracts
• ports
• domain-driven-design
• hexagonal-architecture
• Headgent
• jardisSupport

Published on Packagist.org on 2026-07-21 10:20 UTC

README

Part of Jardis — the Domain-Driven Design platform for PHP. You model your domain; Jardis generates the production-ready hexagonal code (DTOs, Command/Query handlers, repositories, persistence). This package is part of the open-source foundation that generated code runs on.

Consolidated ports and adapters contracts for all Jardis packages — the interface layer that keeps hexagonal architecture honest across the entire ecosystem.

Overview

This package provides all interface contracts for the Jardis ecosystem in a single location. It replaces the previously separate jardisport/* packages.

Namespace	Contracts	Purpose
Auth	10	AuthResult, Authenticator, Credential(+Type), Guard, HashedToken, PasswordHasher, Session, TokenStore(+Type)
ClassVersion	2	Versioned class resolution
Connection	1	Generic connection abstraction
Data	3	Hydration, Identity, FieldMapper
DbConnection	3	ConnectionPool, DbConnection, DatabaseConfig
DbQuery	17	Query Builder, Conditions, Joins, Expressions, Results
DbSchema	2	Schema Reader, Schema Exporter
DotEnv	1	Environment variable loading
EventListener	1	EventListenerRegistry (paired with PSR-14 EventDispatcher)
Filesystem	6	Filesystem (Reader/Writer/Service), FileInfo + Exception
Kernel	6	DomainKernel, ContextResponse, DomainResponse, EventScope, ResponseStatus, GeneratedContextInterface (marker)
Mailer	4	Mailer, MailMessage, MailTransport + Exception
Messaging	10	Publisher, Consumer, MessageHandler + Exceptions
Repository	4	Generic CRUD, PkStrategy, Exceptions
Scheduling	5	Constraint, CronExpression, Schedule(+Violation), ScheduledTask
Secret	2	Secret resolution + Exception
Validation	3	Validator, ValueValidator, ValidationResult
Workflow	8	Workflow engine + orchestration (Workflow, Builder, NodeBuilder, Config, Context, Result, Chain, AggregateResponse) — 7 named transitions: onSuccess, onFail, onTimeout, onSkip, onCancel, onEvent, onExit

88 contracts across 18 domains.

Installation

composer require jardissupport/contracts

Namespace

JardisSupport\Contract\
├── Auth\
├── ClassVersion\
├── Connection\
├── Data\
├── DbConnection\
├── DbQuery\
├── DbSchema\
├── DotEnv\
├── EventListener\
├── Filesystem\
├── Kernel\
├── Mailer\
├── Messaging\
│   └── Exception\
├── Repository\
│   ├── Exception\
│   └── PrimaryKey\
├── Scheduling\
├── Secret\
├── Validation\
└── Workflow\

Kernel — v2 additions (Kernel-Entkopplung)

Three additions to Kernel\ that let a generated domain drop its compile-time dependency on jardiscore/kernel's base classes while keeping the same runtime vocabulary.

ResponseStatus enum

JardisSupport\Contract\Kernel\ResponseStatus — an int-backed enum of domain-neutral response status codes (Success = 200, Created = 201, NoContent = 204, ValidationError = 400, Unauthorized = 401, Forbidden = 403, NotFound = 404, MethodNotAllowed = 405, Conflict = 409, RuleViolation = 422, InternalError = 500), ported 1:1 from jardiscore/kernel's JardisCore\Kernel\Response\ResponseStatus. Generated domains import it from here instead of from jardiscore/kernel.

DomainKernelInterface::eventListenerRegistry()

The Kernel interface (the "Koffer") gained an 11th accessor: eventListenerRegistry(): ?EventListenerRegistryInterface. It is paired with eventDispatcher() — both are typically backed by the same underlying provider instance, one side for dispatching (PSR-14), one side for registering listeners. Generated {Agg}EventRouter scaffolds use this accessor to self-register on the domain facade's constructor. Nullable like every other service on the interface: without a registry, event routing simply stays inactive.

GeneratedContextInterface marker

JardisSupport\Contract\Kernel\GeneratedContextInterface is an empty marker interface. Every generated {Domain}Context implements it, so the resolve path recognizes generated context classes via is_subclass_of($resolved, GeneratedContextInterface::class) — independent of domain boundaries (cross-domain services included) and without requiring a shared package base class to extend.

It took over the detection role of BoundedContextInterface, which was removed from this package in the Kernel-Entkopplung (2026-07) together with the jardiscore/kernel BoundedContext base class it referred to. Generated contexts implement this marker instead of extending a package class.

Design Principles

• One package, all contracts — single dependency for the entire Jardis ecosystem
• Only PSR standards at the Kernel level — PSR-3, PSR-11, PSR-14, PSR-16, PSR-18 + PDO
• No implementation code — interfaces, enums, value objects and exception classes only
• Hexagonal Architecture — contracts define ports, implementations live in adapter/support packages

Migration from jardisport/*

Replace namespace imports:

// Before
use JardisPort\Kernel\DomainKernelInterface;
use JardisPort\DbQuery\DbQueryBuilderInterface;

// After
use JardisSupport\Contract\Kernel\DomainKernelInterface;
use JardisSupport\Contract\DbQuery\DbQueryBuilderInterface;

Replace composer dependency:

// Before
"require": {
    "jardisport/kernel": "^1.0",
    "jardisport/dbquery": "^1.0"
}

// After
"require": {
    "jardissupport/contracts": "^1.0"
}

Related Packages

Package	Role
jardiscore/kernel	DomainKernel (the Koffer) — implements the Kernel\* contracts, provides the 11 infrastructure accessors
jardiscore/app	HTTP-Delivery layer — FastRoute router behind its own interface, PSR-15 middleware pipeline, DomainResponse → PSR-7 mapper, Koffer bootstrap bridge
Generated {Domain}Context	Domain Layer (Builder output) — implements Kernel\GeneratedContextInterface, consumes DomainKernelInterface via resource()
jardissupport/*	Support package implementations
jardisadapter/*	Adapter implementations for external systems

Documentation

Full documentation, guides, and API reference:

docs.jardis.io/en/support/contracts

License

Jardis is open source under the MIT License. Free for any purpose — commercial or non-commercial.

Jardis – Development with Passion Built by Headgent Development