initial

includes/Controllers/RsvPagedResponseTrait.php

@@ -0,0 +1,31 @@
+<?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'])
+        );
+    }
+}