PHPackages                             jardissupport/contract - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PSR & Standards](/categories/psr-standards)
4. /
5. jardissupport/contract

ActiveLibrary[PSR & Standards](/categories/psr-standards)

jardissupport/contract
======================

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

v1.0.0(4w ago)0566↓78.2%17MITPHPPHP >=8.2CI passing

Since Jun 1Pushed 2w agoCompare

[ Source](https://github.com/jardisSupport/contract)[ Packagist](https://packagist.org/packages/jardissupport/contract)[ Docs](https://docs.jardis.io/en/support/contract)[ RSS](/packages/jardissupport-contract/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (6)Dependencies (7)Versions (6)Used By (17)

Jardis Contract
===============

[](#jardis-contract)

[![License: MIT](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE.md)[![PHP Version](https://camo.githubusercontent.com/a68b290dcc313d698dc138a1111aa83eee2f143605449d7e8b5416ea6f88558f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e322d3737374242342e737667)](https://www.php.net/)[![PHPStan Level](https://camo.githubusercontent.com/c51bda247654363d3e30bc352674dd761a9557803a14af0226eb411d6dc0006b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d4c6576656c253230382d627269676874677265656e2e737667)](phpstan.neon)[![PSR-12](https://camo.githubusercontent.com/34b10db0caa29bacd49bda5c437a8de95385f036f3230b31fa605326e18da22c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f64652532305374796c652d5053522d2d31322d626c75652e737667)](phpcs.xml)

> Part of **[Jardis](https://jardis.io)** — 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
--------

[](#overview)

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

NamespaceContractsPurpose`Kernel`4DomainKernel, BoundedContext, ContextResponse, DomainResponse`ClassVersion`2Versioned class resolution`Connection`1Generic connection abstraction`Data`3Hydration, Identity, FieldMapper`DbConnection`3ConnectionPool, DbConnection, DatabaseConfig`DbQuery`17Query Builder, Conditions, Joins, Expressions, Results`DbSchema`2Schema Reader, Schema Exporter`DotEnv`1Environment variable loading`Messaging`10Publisher, Consumer, MessageHandler + Exceptions`Repository`4Generic CRUD, PkStrategy, Exceptions`Secret`2Secret resolution + Exception`Validation`3Validator, ValueValidator, ValidationResult`Mailer`4Mailer, MailMessage, MailTransport + Exception`Filesystem`5Filesystem (Reader/Writer), FileInfo + Exception`Workflow`6Workflow engine + orchestration (Workflow, Builder, NodeBuilder, Config, Context, Result) — 7 named transitions: `onSuccess`, `onFail`, `onTimeout`, `onSkip`, `onCancel`, `onEvent`, `onExit`**67 contracts** across 15 domains.

---

Installation
------------

[](#installation)

```
composer require jardissupport/contract
```

---

Namespace
---------

[](#namespace)

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

```

---

Design Principles
-----------------

[](#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/\*
----------------------------

[](#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/contract": "^1.0"
}
```

---

Related Packages
----------------

[](#related-packages)

PackageRole`jardiscore/kernel`Kernel contract implementation`jardiscore/foundation`Full DDD platform on top of Kernel`jardissupport/*`Support package implementations`jardisadapter/*`Adapter implementations for external systems---

Documentation
-------------

[](#documentation)

Full documentation, guides, and API reference:

**[docs.jardis.io/en/support/contract](https://docs.jardis.io/en/support/contract)**

---

License
-------

[](#license)

Jardis is open source under the [MIT License](LICENSE.md). Free for any purpose — commercial or non-commercial.

---

*Jardis – Development with Passion**Built by [Headgent Development](https://headgent.com)*

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance96

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

29d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e07a1b668e9e01ee6d1b85de7b3be1c2513f68aae9494b2011d1592104d5daa0?d=identicon)[jardis](/maintainers/jardis)

---

Top Contributors

[![Headgent](https://avatars.githubusercontent.com/u/245725954?v=4)](https://github.com/Headgent "Headgent (11 commits)")

---

Tags

contractsdomain-driven-designhexagonal-architectureinterfacesjardisphpportsinterfacescontractsdddHeadgentjardisSupport

###  Code Quality

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/jardissupport-contract/health.svg)

```
[![Health](https://phpackages.com/badges/jardissupport-contract/health.svg)](https://phpackages.com/packages/jardissupport-contract)
```

###  Alternatives

[symfony/symfony

The Symfony PHP framework

31.4k86.9M2.2k](/packages/symfony-symfony)[cakephp/cakephp

The CakePHP framework

8.8k19.1M1.7k](/packages/cakephp-cakephp)[laravel/framework

The Laravel Framework.

34.8k532.1M19.4k](/packages/laravel-framework)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6941.5M398](/packages/drupal-core-recommended)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751284.3k37](/packages/civicrm-civicrm-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)