aetah/jrd

JSON Resource Descriptor (JRD) models, parser, and serializer.

0.2.0 2026-06-18 09:22 UTC

Requires

• php: ^8.3
• ext-json: *

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.1
• squizlabs/php_codesniffer: ^4.0

AGPL-3.0-or-later

README

This repository is a read-only split of aetah/php-openid-toolkit.

• Development happens in the monorepo.
• Feature PRs and issues should be opened against aetah/php-openid-toolkit.
• This split repository is published from the monorepo and should not be treated as the source of truth.

JRD

Generic PHP library for parsing, validating, and serializing JSON Resource Descriptors (JRD).

Scope

This package provides:

• immutable JRD domain models
• parsing from arrays and JSON
• serialization to arrays and JSON
• JRD-specific structural validation

It deliberately does not provide WebFinger URL building, HTTP transport, or framework integration.

Install

composer require aetah/jrd

Quick Start

<?php

declare(strict_types=1);

use Aetah\Jrd\Service\JrdParser;
use Aetah\Jrd\Service\JrdSerializer;

$parser = new JrdParser();
$serializer = new JrdSerializer();

$jrd = $parser->parseJson('{"subject":"acct:[e-mail]"}');

$json = $serializer->toJson($jrd);

Quality Checks

Run Static Analysis

composer analyse

Run Tests

composer test

Clean Build Artifacts

composer clean

Run Test Coverage

composer test:coverage

Run Style Checks

composer lint

Fix Style Checks

composer lint:fix

License

Licensed under AGPL-3.0-or-later. See LICENSE for details.