@typespec/http-specs 0.1.0-alpha.0

package/specs/type/model/usage/mockapi.ts

@@ -0,0 +1,45 @@
+import { json, passOnSuccess, ScenarioMockApi } from "@typespec/spec-api";
+
+export const Scenarios: Record<string, ScenarioMockApi> = {};
+
+const body = { requiredProp: "example-value" };
+
+Scenarios.Type_Model_Usage_input = passOnSuccess({
+  uri: "/type/model/usage/input",
+  method: "post",
+  request: {
+    body: {
+      requiredProp: "example-value",
+    },
+  },
+  response: {
+    status: 204,
+  },
+  kind: "MockApiDefinition",
+});
+
+Scenarios.Type_Model_Usage_output = passOnSuccess({
+  uri: "/type/model/usage/output",
+  method: "get",
+  request: {},
+  response: {
+    status: 200,
+    body: json(body),
+  },
+  kind: "MockApiDefinition",
+});
+
+Scenarios.Type_Model_Usage_inputAndOutput = passOnSuccess({
+  uri: "/type/model/usage/input-output",
+  method: "post",
+  request: {
+    body: {
+      requiredProp: "example-value",
+    },
+  },
+  response: {
+    status: 200,
+    body: json(body),
+  },
+  kind: "MockApiDefinition",
+});

package/specs/type/model/visibility/main.tsp

@@ -0,0 +1,153 @@
+import "@typespec/http";
+import "@typespec/spector";
+
+using Http;
+using Spector;
+
+@doc("Illustrates models with visibility properties.")
+@scenarioService("/type/model/visibility")
+namespace Type.Model.Visibility;
+
+@doc("Output model with visibility properties.")
+model VisibilityModel {
+  @doc("Required string, illustrating a readonly property.")
+  @visibility("read")
+  readProp: string;
+
+  @doc("Required int32, illustrating a query property.")
+  @visibility("query")
+  queryProp: int32;
+
+  @doc("Required string[], illustrating a create property.")
+  @visibility("create")
+  createProp: string[];
+
+  @doc("Required int32[], illustrating a update property.")
+  @visibility("update")
+  updateProp: int32[];
+
+  @doc("Required bool, illustrating a delete property.")
+  @visibility("delete")
+  deleteProp: boolean;
+}
+
+/** RoundTrip model with readonly optional properties. */
+model ReadOnlyModel {
+  /** Optional readonly nullable int list. */
+  @visibility("read")
+  optionalNullableIntList?: int32[] | null;
+
+  /** Optional readonly string dictionary. */
+  @visibility("read")
+  optionalStringRecord?: Record<string>;
+}
+
+@scenario
+@scenarioDoc("""
+  Generate and receive output model with readonly properties.
+  Expected input body:
+  ```json
+  {
+    queryProp: 123,
+  }
+  ```
+  
+  Expected response body:
+  ```json
+  {
+    readProp: "abc",
+  }
+  ```
+  """)
+@get
+op getModel(@body input: VisibilityModel): {
+  @body
+  output: VisibilityModel;
+};
+
+@scenario
+@scenarioDoc("""
+  Generate abd send put model with write/create properties.
+  Expected input body:
+  ```json
+  {
+    queryProp: 123,
+  }
+  ```
+  """)
+@head
+op headModel(@body input: VisibilityModel): OkResponse;
+
+@scenario
+@scenarioDoc("""
+  Generate abd send put model with write/create/update properties.
+  Expected input body:
+  ```json
+  {
+    createProp: ["foo", "bar"],
+    updateProp: [1, 2],
+  }
+  ```
+  """)
+@put
+op putModel(@body input: VisibilityModel): void;
+
+@scenario
+@scenarioDoc("""
+  Generate abd send put model with write/update properties.
+  Expected input body:
+  ```json
+  {
+    updateProp: [1, 2],
+  }
+  ```
+  """)
+@patch
+op patchModel(@body input: VisibilityModel): void;
+
+@scenario
+@scenarioDoc("""
+  Generate abd send put model with write/create properties.
+  Expected input body:
+  ```json
+  {
+    createProp: ["foo", "bar"],
+  }
+  ```
+  """)
+@post
+op postModel(@body input: VisibilityModel): void;
+
+@scenario
+@scenarioDoc("""
+  Generate abd send put model with write/create properties.
+  Expected input body:
+  ```json
+  {
+    deleteProp: true,
+  }
+  ```
+  """)
+@delete
+op deleteModel(@body input: VisibilityModel): void;
+
+@route("/readonlyroundtrip")
+@scenario
+@scenarioDoc("""
+  Generate and receive output model with readonly properties.
+  
+  Expected input body:
+  ```json
+  {}
+  ```
+  
+  Expected response body:
+  ```json
+  {
+    optionalNullableIntList: [1, 2, 3],
+    optionalStringRecord: { k1: "value1", k2: "value2" },
+  }
+  ```
+  """)
+@put
+op putReadOnlyModel(@body input: ReadOnlyModel): ReadOnlyModel;

package/specs/type/model/visibility/mockapi.ts

@@ -0,0 +1,108 @@
+import { json, passOnSuccess, ScenarioMockApi } from "@typespec/spec-api";
+
+export const Scenarios: Record<string, ScenarioMockApi> = {};
+
+function genData(keys: string[]): Record<string, any> {
+  const ret: Record<string, any> = {};
+  const fullData: Record<string, any> = {
+    readProp: "abc",
+    queryProp: 123,
+    createProp: ["foo", "bar"],
+    updateProp: [1, 2],
+    deleteProp: true,
+  };
+  for (const k of keys) {
+    if (k in fullData) {
+      ret[k] = fullData[k];
+    }
+  }
+  return ret;
+}
+const expectBody = {
+  optionalNullableIntList: [1, 2, 3],
+  optionalStringRecord: { k1: "value1", k2: "value2" },
+};
+Scenarios.Type_Model_Visibility_putReadOnlyModel = passOnSuccess({
+  uri: "/type/model/visibility/readonlyroundtrip",
+  method: "put",
+  request: {},
+  response: {
+    status: 200,
+    body: json(expectBody),
+  },
+  kind: "MockApiDefinition",
+});
+Scenarios.Type_Model_Visibility_headModel = passOnSuccess({
+  uri: "/type/model/visibility",
+  method: "head",
+  request: {
+    body: { queryProp: 123 },
+  },
+  response: {
+    status: 200,
+  },
+  kind: "MockApiDefinition",
+});
+Scenarios.Type_Model_Visibility_getModel = passOnSuccess({
+  uri: "/type/model/visibility",
+  method: "get",
+  request: {
+    body: { queryProp: 123 },
+  },
+  response: {
+    status: 200,
+    body: json(genData(["readProp"])),
+  },
+  kind: "MockApiDefinition",
+});
+Scenarios.Type_Model_Visibility_putModel = passOnSuccess({
+  uri: "/type/model/visibility",
+  method: "put",
+  request: {
+    body: {
+      createProp: ["foo", "bar"],
+      updateProp: [1, 2],
+    },
+  },
+  response: {
+    status: 204,
+  },
+  kind: "MockApiDefinition",
+});
+Scenarios.Type_Model_Visibility_patchModel = passOnSuccess({
+  uri: "/type/model/visibility",
+  method: "patch",
+  request: {
+    body: {
+      updateProp: [1, 2],
+    },
+  },
+  response: {
+    status: 204,
+  },
+  kind: "MockApiDefinition",
+});
+Scenarios.Type_Model_Visibility_postModel = passOnSuccess({
+  uri: "/type/model/visibility",
+  method: "post",
+  request: {
+    body: {
+      createProp: ["foo", "bar"],
+    },
+  },
+  response: {
+    status: 204,
+  },
+  kind: "MockApiDefinition",
+});
+Scenarios.Type_Model_Visibility_deleteModel = passOnSuccess({
+  uri: "/type/model/visibility",
+  method: "delete",
+  request: {
+    body: { deleteProp: true },
+  },
+  response: {
+    status: 204,
+  },
+  kind: "MockApiDefinition",
+});