<?php

trait RsvPagedResponseTrait {
    private function paged_response(array $data, ?int $total = null): WP_REST_Response {
        return new WP_REST_Response([
            'total' => $total ?? count($data),
            'data'  => $data,
        ], 200);
    }

    /**
     * Read pagination from the request as [skip, limit]. limit is clamped to
     * 1..100 and defaults to 20; skip defaults to 0.
     *
     * @return array{0:int,1:int}
     */
    private static function paging(WP_REST_Request $request): array {
        $skip  = max(0, (int) $request->get_param('skip'));
        $limit = (int) $request->get_param('limit');
        $limit = $limit > 0 ? min($limit, 100) : 20;
        return [$skip, $limit];
    }

    /** Extract writable (non-readonly) properties from a schema for use as route args. */
    private static function input_args(array $schema): array {
        return array_filter(
            $schema['properties'],
            fn(array $prop): bool => empty($prop['readonly'])
        );
    }
}