codecov CI OpenSSF Scorecard PHP Version License: MIT Packagist Version

The JOOservices DTO Library is a PHP 8.5+ library for constructor-based DTO hydration, mutable data objects, opt-in validation, serialization control, and DTO collection wrappers.

Package name: jooservices/dto

Latest stable release: v1.0.6

composer require jooservices/dto

use DateTimeImmutable;
use JOOservices\Dto\Attributes\MapFrom;
use JOOservices\Dto\Core\Dto;
final class UserDto extends Dto
{
 public function __construct(
 public readonly string $id,
 #[MapFrom('email_address')]
 public readonly string $email,
 public readonly DateTimeImmutable $createdAt,
 ) {}
}
$user = UserDto::from([
 'id' => 'u_123',
 'email_address' => 'john@example.com',
 'createdAt' => '2026年01月15日T10:30:00+00:00',
]);
$payload = $user->toArray();

• Dto and Data
• hydration from arrays, JSON strings, and simple public-property objects
• scalar, enum, and DateTimeInterface casting
• nested single DTO hydration
• class-level polymorphic DTO hydration with #[DiscriminatorMap]
• typed array hydration from common PHPDoc annotations such as Type[], array<Type>, and list<Type>
• fallback property defaults with #[DefaultFrom]
• opt-in validation with attributes
• serialization filtering and wrapping
• lazy derived serialization through ComputesLazyProperties
• DataCollection and PaginatedCollection

• several declared attributes are still only partially wired into runtime behavior; Computed, Deprecated, OptionalProperty, and Context::$globalPipeline remain incomplete, and Pipeline support is limited to current property-level execution paths rather than a broader end-to-end pipeline system
• StrictType now affects input shape enforcement and implicit casting rules, but related pipeline and schema behavior remains narrower than the declared attribute surface

Start with:

• Documentation Hub
• Changelog
• AI Skills Usage Guide
• phpDocumentor config for future API reference generation: phpdoc.dist.xml
• Installation
• Quick Start
• Risks, Legacy, and Gaps

This repository includes an AI skill pack for agents working in Cursor, Claude Code, VS Code, JetBrains, and Antigravity.

Start with:

• AGENTS.md
• CLAUDE.md
• AI Skills Map
• AI Skills Usage Guide

The canonical skill source lives in .github/skills/, with adapter layers for each supported AI environment.

composer lint
composer lint:all
composer test
composer test:coverage
composer check
composer ci

Contributor workflow details live in:

• Setup
• Contributing
• CI/CD
• Release Process
• AI Skills

Approved Git flow summary:

• normal feature and fix work branches from develop and PRs back into develop
• release preparation uses release/<version> from develop, then PRs into master
• releases are tagged from master
• master merges back into develop after release or hotfix completion

• Contributing
• Security Policy
• Code of Conduct

Current GitHub Actions coverage:

• CI: security checks, linting, tests, 95% minimum statement coverage, coverage upload, and optional SonarQube Cloud analysis when SONAR_TOKEN is configured
• Release: validate tags, create GitHub releases, trigger Packagist update
• PR Labeler: apply labels to pull requests
• Semantic PR Title: enforce pull request title format
• OpenSSF Scorecard: publish scorecard results as SARIF
• Secret Scanning: workflow file exists, but the gitleaks job is currently disabled

External services currently used by workflows:

• Codecov for coverage upload in ci.yml
• Packagist update webhook in release.yml
• GitHub Releases and GitHub Discussions in release.yml
• OpenSSF Scorecard in scorecard.yml
• GitHub SARIF upload through CodeQL infrastructure in scorecard.yml

Important notes:

• No workflow currently defines Docker-style services: containers such as MySQL, Redis, or PostgreSQL.
• SonarQube Cloud analysis is present in ci.yml, but it only runs after tests pass and only when SONAR_TOKEN is available.

This project is licensed under the MIT License.