Download the PHP package youmad/endurance-activity without Composer
On this page you can find all versions of the php package youmad/endurance-activity. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download youmad/endurance-activity
More information about youmad/endurance-activity
Files in youmad/endurance-activity
Package endurance-activity
Short Description Framework-agnostic domain model and application services for endurance activities
License MPL-2.0
Informations about the package endurance-activity
Endurance Activity
Domain model and application services for endurance activities: lifecycle, measurements, laps, sessions, devices and summaries.
Installation
Requires PHP ^8.5.
Activity lifecycle
Lifecycle and summary inconsistencies raise domain exceptions. The model retains reported measurements and distinguishes active timer duration from elapsed time. Pool lengths and segment efforts are represented as activity details.
Streaming imports
Application\UseCase\ImportActivityStream consumes ActivityImportItem streams.
An import is staged under a generation and becomes visible after successful
activation. The application implements the persistence, transaction and recovery
interfaces in Application\Port and configures the item handlers.
Ready-made integrations are available in
youmad/endurance-activity-fit
and
youmad/endurance-activity-postgresql.
Measurements and timelines
Observations support scalar, text, position, range, vector and array readings.
Track read models retain repeated scalar types in their original order, with
unit, origin and source attribution. UnambiguousScalarMeasurements::byType()
returns only types with exactly one reading. Lap and Session summaries require
unique measurement types.
Source-specific metadata implements Telemetry\MeasurementMetadata with a stable
namespaced type, positive schema version and JSON-compatible data.
Lap::create() and ActivitySession::create() accept a SummaryAdjacencyPolicy
separately from timeline precision. NonOverlapping permits gaps and rejects
all overlaps. AbutWithinTwoWholeSeconds permits at most two seconds between
whole-second boundary views, without changing stored timestamps. The later
summary selects the policy for each adjacent pair. If omitted, second precision
selects abutment and microsecond precision selects non-overlap.
Development
From a source checkout:
License
MPL-2.0.