PHPackages                             seablast/interfaces - 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. seablast/interfaces

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

seablast/interfaces
===================

Shared interface contracts for the Seablast for PHP ecosystem, currently including the IdentityManagerInterface contract.

v0.1.3(6d ago)06.2k2MITShellPHP >=7.2 <8.6CI passing

Since May 19Pushed 6d ago1 watchersCompare

[ Source](https://github.com/WorkOfStan/seablast-interfaces)[ Packagist](https://packagist.org/packages/seablast/interfaces)[ RSS](/packages/seablast-interfaces/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (3)DependenciesVersions (9)Used By (2)

`Seablast Interfaces`
=====================

[](#seablast-interfaces)

[![Total Downloads](https://camo.githubusercontent.com/a1acdef3654f878576735ad87b82ae23196f2f8b544e9830828c9637703caf87/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736561626c6173742f696e74657266616365732e737667)](https://packagist.org/packages/seablast/interfaces)[![Latest Stable Version](https://camo.githubusercontent.com/f557fbdc8e858eae165b660e9f4c87b89b9018789c4d3d1ebddaf8f8ecb80fb6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736561626c6173742f696e74657266616365732e737667)](https://packagist.org/packages/seablast/interfaces)[![Polish the code](https://github.com/WorkOfStan/seablast-interfaces/actions/workflows/polish-the-code.yml/badge.svg)](https://github.com/WorkOfStan/seablast-interfaces/actions/workflows/polish-the-code.yml)

A dedicated repository for shared interfaces related to the [Seablast for PHP](https://github.com/WorkOfStan/seablast) ecosystem. This package currently provides the `IdentityManagerInterface` contract for identity-related integrations. By consolidating shared interfaces in one place, Seablast Interfaces ensures consistency, reusability, and maintainability across different components of the Seablast framework.

Key Features
------------

[](#key-features)

- **Centralized Interface Definitions**: Provides a single source of truth for shared interfaces used in the Seablast ecosystem, ensuring uniform implementation across different libraries and plugins.
- **Enhanced Modularity**: Facilitates the development and maintenance of modular components by decoupling interface definitions from their implementations.
- **Improved Reusability**: Interfaces defined in Seablast Interfaces can be easily reused by various libraries and plugins, promoting code reuse and reducing duplication.
- **Ease of Integration**: Simplifies the integration process for new libraries and plugins by providing clear and well-documented interfaces that they can implement.
- **Consistent API**: Ensures that all components adhering to the `Seablast` standards follow a consistent API, making it easier for developers to work with the ecosystem.

Usage
-----

[](#usage)

To use the interfaces defined in Seablast Interfaces within your project, simply include the repository as a dependency in your `composer.json` file:

```
{
  "require": {
    "seablast/interfaces": "^0.1.3"
  }
}
```

Then, run `composer install` or `composer update` to install the dependency and set up autoloading.

Example
-------

[](#example)

Here's an example of how to implement an interface from Seablast Interfaces:

```
// src/IdentityManager.php in a package that consumes seablast/interfaces
namespace Seablast\Auth;

use Seablast\Interfaces\IdentityManagerInterface;

final class IdentityManager implements IdentityManagerInterface
{
    public function getGroups(): array
    {
        return [1, 2];
    }

    public function getRoleId(): int
    {
        return 1;
    }

    public function getUserId(): int
    {
        return 123;
    }

    public function isAuthenticated(): bool
    {
        return true;
    }
}
```

For unauthenticated users, implementations are recommended to throw an exception from `getRoleId()` and `getUserId()`. `getGroups()` may either return an empty array or throw an exception.

Contribution
------------

[](#contribution)

We welcome contributions to Seablast Interfaces. If you have suggestions for new interfaces or improvements to existing ones, please open an issue or submit a pull request on our GitHub repository.

License
-------

[](#license)

Seablast Interfaces is open-source software licensed under the [MIT License](LICENSE).

Contact
-------

[](#contact)

For any questions or support, please contact our development team at .

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance98

Actively maintained with recent releases

Popularity23

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity54

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

Every ~256 days

Total

4

Last Release

6d ago

PHP version history (3 changes)v0.1PHP ^7.2 || ^8.0

v0.1.1PHP >=7.2 <8.5

v0.1.2PHP >=7.2 <8.6

### Community

Maintainers

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

---

Top Contributors

[![WorkOfStan](https://avatars.githubusercontent.com/u/26247074?v=4)](https://github.com/WorkOfStan "WorkOfStan (10 commits)")

### Embed Badge

![Health badge](/badges/seablast-interfaces/health.svg)

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

###  Alternatives

[maclof/kubernetes-client

A simple yet elegant client for accessing and controlling a Kubernetes cluster.

237916.9k5](/packages/maclof-kubernetes-client)

PHPackages © 2026

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