HYPERFLEET-1272 - refactor: rename query params pageSize→size and orderBy→order

CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.24] - 2026-06-24
+
+### Changed
+
+- Rename `pageSize` query parameter to `size` (HYPERFLEET-1272)
+- Rename `orderBy` query parameter to `order` (HYPERFLEET-1272)
+
+### Removed
+
+- `OrderDirection` enum (unused; direction is encoded in the `order` string parameter)
+- Separate `order?: OrderDirection` query parameter (absorbed by renamed `order` string parameter)
+
 ## [1.0.23] - 2026-06-22
 
 ### Changed

main.tsp

@@ -30,7 +30,7 @@ using OpenAPI;
  */
 @service(#{ title: "HyperFleet API" })
 @info(#{
-  version: "1.0.23",
+  version: "1.0.24",
   contact: #{
     name: "HyperFleet Team",
     url: "https://github.com/openshift-hyperfleet",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperfleet",
-  "version": "1.0.23",
+  "version": "1.0.24",
   "type": "module",
   "exports": {
     "./*": "./*"

schemas/core/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: HyperFleet API
-  version: 1.0.23
+  version: 1.0.24
   contact:
     name: HyperFleet Team
     url: https://github.com/openshift-hyperfleet
@@ -30,8 +30,7 @@ paths:
       parameters:
         - $ref: '#/components/parameters/SearchParams'
         - $ref: '#/components/parameters/QueryParams.page'
-        - $ref: '#/components/parameters/QueryParams.pageSize'
-        - $ref: '#/components/parameters/QueryParams.orderBy'
+        - $ref: '#/components/parameters/QueryParams.size'
         - $ref: '#/components/parameters/QueryParams.order'
       responses:
         '200':
@@ -387,8 +386,7 @@ paths:
             type: string
         - $ref: '#/components/parameters/SearchParams'
         - $ref: '#/components/parameters/QueryParams.page'
-        - $ref: '#/components/parameters/QueryParams.pageSize'
-        - $ref: '#/components/parameters/QueryParams.orderBy'
+        - $ref: '#/components/parameters/QueryParams.size'
         - $ref: '#/components/parameters/QueryParams.order'
       responses:
         '200':
@@ -784,8 +782,7 @@ paths:
             type: string
         - $ref: '#/components/parameters/SearchParams'
         - $ref: '#/components/parameters/QueryParams.page'
-        - $ref: '#/components/parameters/QueryParams.pageSize'
-        - $ref: '#/components/parameters/QueryParams.orderBy'
+        - $ref: '#/components/parameters/QueryParams.size'
         - $ref: '#/components/parameters/QueryParams.order'
       responses:
         '200':
@@ -894,8 +891,7 @@ paths:
             type: string
         - $ref: '#/components/parameters/SearchParams'
         - $ref: '#/components/parameters/QueryParams.page'
-        - $ref: '#/components/parameters/QueryParams.pageSize'
-        - $ref: '#/components/parameters/QueryParams.orderBy'
+        - $ref: '#/components/parameters/QueryParams.size'
         - $ref: '#/components/parameters/QueryParams.order'
       responses:
         '200':
@@ -992,8 +988,7 @@ paths:
       parameters:
         - $ref: '#/components/parameters/SearchParams'
         - $ref: '#/components/parameters/QueryParams.page'
-        - $ref: '#/components/parameters/QueryParams.pageSize'
-        - $ref: '#/components/parameters/QueryParams.orderBy'
+        - $ref: '#/components/parameters/QueryParams.size'
         - $ref: '#/components/parameters/QueryParams.order'
       responses:
         '200':
@@ -1032,8 +1027,7 @@ paths:
       parameters:
         - $ref: '#/components/parameters/SearchParams'
         - $ref: '#/components/parameters/QueryParams.page'
-        - $ref: '#/components/parameters/QueryParams.pageSize'
-        - $ref: '#/components/parameters/QueryParams.orderBy'
+        - $ref: '#/components/parameters/QueryParams.size'
         - $ref: '#/components/parameters/QueryParams.order'
       responses:
         '200':
@@ -1333,8 +1327,7 @@ paths:
             type: string
         - $ref: '#/components/parameters/SearchParams'
         - $ref: '#/components/parameters/QueryParams.page'
-        - $ref: '#/components/parameters/QueryParams.pageSize'
-        - $ref: '#/components/parameters/QueryParams.orderBy'
+        - $ref: '#/components/parameters/QueryParams.size'
         - $ref: '#/components/parameters/QueryParams.order'
       responses:
         '200':
@@ -1428,13 +1421,6 @@ components:
       name: order
       in: query
       required: false
-      schema:
-        $ref: '#/components/schemas/OrderDirection'
-      explode: false
-    QueryParams.orderBy:
-      name: orderBy
-      in: query
-      required: false
       schema:
         type: string
         default: created_time
@@ -1449,8 +1435,8 @@ components:
         minimum: 1
         default: 1
       explode: false
-    QueryParams.pageSize:
-      name: pageSize
+    QueryParams.size:
+      name: size
       in: query
       required: false
       schema:
@@ -2359,11 +2345,6 @@ components:
         href:
           type: string
           description: Resource URI
-    OrderDirection:
-      type: string
-      enum:
-        - asc
-        - desc
     ProblemDetails:
       type: object
       required:

shared/models/common/model.tsp

@@ -175,11 +175,6 @@ model Page<Kind> {
     items: Kind[];
 }
 
-enum OrderDirection {
-    asc,
-    desc,
-}
-
 model SearchParams {
     /** Filter results using TSL (Tree Search Language) query syntax.
      * Examples: `status.conditions.Reconciled='True'`, `name in ('c1','c2')`, `labels.region='us-east'` */
@@ -195,13 +190,10 @@ model QueryParams {
 
     @query
     @minValue(1)
-    pageSize?: int32 = 20;
-
-    @query
-    orderBy?: string = "created_time";
+    size?: int32 = 20;
 
     @query
-    order?: OrderDirection;
+    order?: string = "created_time";
 }
 
 model List<T> {