API reference

API reference

This reference documents the stable source-neutral contracts used by both Android and Linux. Package names are authoritative; concrete UI classes remain implementation details unless listed here.

Packages

Package	Purpose
dev.properpcloud.core.model	Stable identities, media nodes, sources, queue, sorting, and progress policy.
dev.properpcloud.source.pcloud	pCloud node mapping, session creation, source adapter, and verified metadata download.
dev.properpcloud.source.webdav	Portable WebDAV endpoint contract.
dev.properpcloud.metadata.tags	Embedded tag parsing and mutation boundary.
dev.properpcloud.metadata.online	Online metadata lookup boundary and provider implementations.
dev.properpcloud.desktop.*	Linux platform adapters and orchestration.

Contract pages

• Core media and source API
• Queue and sorting API
• Progress API
• pCloud adapter API
• Desktop platform API
• Persistence schema

Stability rules

• SourceId and NodeId string formats are persisted and must remain backward-compatible.
• AudioSource methods are suspend functions and may perform network or disk I/O.
• A StreamHandle is transient and must not be used as an identity key.
• Queue reducer operations are pure and deterministic.
• New persisted fields require migration fixtures and compatibility tests.