[http-spec] add link case of server driven pagination test

.chronus/changes/list_operation_test-2024-10-27-18-41-40.md

@@ -0,0 +1,7 @@
+---
+changeKind: feature
+packages:
+  - "@typespec/http-specs"
+---
+
+add link case of server driven pagination test

packages/http-specs/specs/operations/list/main.tsp

@@ -0,0 +1,60 @@
+import "@typespec/http";
+import "@typespec/spector";
+
+using Http;
+using Spector;
+
+/**
+ * Test for list operations.
+ */
+@scenarioService("/operations/list")
+namespace Operations.List;
+
+model Pet {
+  id: string;
+  name: string;
+}
+
+@route("/server-driven-pagination")
+namespace ServerDrivenPagination {
+  @scenario
+  @scenarioDoc("""
+    Test case for using link as pagination. 
+
+    Two requests need to be tested.
+    1. Initial request:
+    Expected route: /operations/list/server-driven-pagination/link
+    Expected response body:
+    ```json
+    { "pets": [
+        { "id": "1", "name": "dog" },
+        { "id": "2", "name": "cat" }
+      ],
+      "links": {
+        "next": "/operations/list/server-driven-pagination/link/nextPage"
+      }
+    }
+    2. Next page request:
+    Expected route: /operations/list/server-driven-pagination/link/nextPage
+    Expected response body:
+    ```json
+    { "pets": [
+        { "id": "3", "name": "bird" },
+        { "id": "4", "name": "fish" }
+      ]
+    }
+    ```
+    """)
+  @route("/link")
+  op link(): {
+    @pageItems
+    pets: Pet[];
+
+    links: {
+      @nextLink next?: url;
+      @prevLink prev?: url;
+      @firstLink first?: url;
+      @lastLink last?: url;
+    };
+  };
+}

packages/http-specs/specs/operations/list/mockapi.ts

@@ -0,0 +1,39 @@
+import { json, passOnSuccess, ScenarioMockApi } from "@typespec/spec-api";
+
+export const Scenarios: Record<string, ScenarioMockApi> = {};
+
+Scenarios.Operations_List_ServerDrivenPagination_link = passOnSuccess([
+  {
+    uri: "/operations/list/server-driven-pagination/link",
+    method: "get",
+    request: {},
+    response: {
+      status: 200,
+      body: json({
+        pets: [
+          { id: "1", name: "dog" },
+          { id: "2", name: "cat" },
+        ],
+        links: {
+          next: "/operations/list/server-driven-pagination/link/nextPage",
+        },
+      }),
+    },
+    kind: "MockApiDefinition",
+  },
+  {
+    uri: "/operations/list/server-driven-pagination/link/nextPage",
+    method: "get",
+    request: {},
+    response: {
+      status: 200,
+      body: json({
+        pets: [
+          { id: "3", name: "bird" },
+          { id: "4", name: "fish" },
+        ],
+      }),
+    },
+    kind: "MockApiDefinition",
+  },
+]);