waaseyaa/ingestion

Payload validation and ingestion utilities for Waaseyaa applications

Maintainers

Package info

github.com/waaseyaa/ingestion

pkg:composer/waaseyaa/ingestion

Transparency log

Statistics

Installs: 1 805

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.1.0-alpha.259 2026-07-01 03:19 UTC

Requires

  • php: >=8.5

Requires (Dev)

GPL-2.0-or-later 4e4eecd6b9c736991ff606ab55d52a2771a0dc3d

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

This package is auto-updated.

Last update: 2026-07-10 21:38:34 UTC

README

Layer 0 — Foundation

Payload validation and ingestion utilities for Waaseyaa applications.

EnvelopeValidator is an abstract, @internal base class that enforces the canonical ingestion envelope shape; applications extend it to provide their supported versions, entity types, and entity-specific validation. The required envelope fields are payload_id, version, source, snapshot_type, timestamp, entity_type, source_url, and data. PayloadValidatorInterface is the per-domain hook for content-specific validation; EnvelopeValidator implements it. ValidationResult is a readonly @api DTO carrying a list<string> of free-form error message strings (public array $errors) and an isValid() helper that returns true when $errors is empty — there are no structured error codes in this package.

Key classes: EnvelopeValidator (abstract, @internal), PayloadValidatorInterface, ValidationResult.

No framework consumer yet. These validators are self-contained and unit-tested, but nothing in the framework currently depends on or invokes this package — no other package requires waaseyaa/ingestion, and no provider, route, or CLI wires EnvelopeValidator/PayloadValidatorInterface. It is a standalone building block an application can adopt directly, not a wired pipeline. (Note: the foundation-layer ingestion pipeline described in docs/specs/ingestion-defaults.md is a separate Waaseyaa\Foundation\Ingestion\* stack, not this package.)