@typespec/http-specs 0.1.0-alpha.9-dev.5 → 0.1.0-dev.0

package/specs/authentication/noauth/union/main.tsp

@@ -0,0 +1,30 @@
+import "@typespec/http";
+import "@typespec/spector";
+
+using Http;
+using Spector;
+
+@scenarioService("/authentication/noauth/union")
+@doc("Illustrates clients generated with NoAuth and OAuth2 authentication union.")
+@useAuth(NoAuth | OAuth2Auth<[MyFlow]>)
+namespace Authentication.Noauth.Union;
+
+model MyFlow {
+  type: OAuth2FlowType.implicit;
+  authorizationUrl: "https://login.microsoftonline.com/common/oauth2/authorize";
+  scopes: ["https://security.microsoft.com/.default"];
+}
+
+@scenario
+@scenarioDoc("Expects no authentication. The server accepts requests without any authentication header.")
+@doc("Check whether client can make a request without authentication")
+@get
+@route("/valid")
+op validNoAuth(): NoContentResponse;
+
+@scenario
+@scenarioDoc("Expects header 'authorization': 'Bearer https://security.microsoft.com/.default'")
+@doc("Check whether client is authenticated with OAuth2 token")
+@get
+@route("/validtoken")
+op validToken(): NoContentResponse;

package/specs/authentication/noauth/union/mockapi.ts

@@ -0,0 +1,27 @@
+import { passOnSuccess, ScenarioMockApi } from "@typespec/spec-api";
+
+export const Scenarios: Record<string, ScenarioMockApi> = {};
+
+Scenarios.Authentication_Noauth_Union_validNoAuth = passOnSuccess({
+  uri: `/authentication/noauth/union/valid`,
+  method: "get",
+  request: {},
+  response: {
+    status: 204,
+  },
+  kind: "MockApiDefinition",
+});
+
+Scenarios.Authentication_Noauth_Union_validToken = passOnSuccess({
+  uri: `/authentication/noauth/union/validtoken`,
+  method: "get",
+  request: {
+    headers: {
+      authorization: "Bearer https://security.microsoft.com/.default",
+    },
+  },
+  response: {
+    status: 204,
+  },
+  kind: "MockApiDefinition",
+});

package/specs/documentation/main.tsp

@@ -0,0 +1,158 @@
+import "@typespec/http";
+import "@typespec/spector";
+
+using Http;
+using Spector;
+
+@scenarioService("/documentation")
+@doc("Illustrates documentation generation and formatting features")
+namespace Documentation;
+
+@route("/lists")
+namespace Lists {
+  /**
+   * This tests:
+   * - Simple bullet point. This bullet point is going to be very long to test how text wrapping is handled in bullet points within documentation comments. It should properly indent the wrapped lines.
+   * - Another bullet point with **bold text**. This bullet point is also intentionally long to see how the formatting is preserved when the text wraps onto multiple lines in the generated documentation.
+   * - Third bullet point with *italic text*. Similar to the previous points, this one is extended to ensure that the wrapping and formatting are correctly applied in the output.
+   * - Complex bullet point with **bold** and *italic* combined. This bullet point combines both bold and italic formatting and is long enough to test the wrapping behavior in such cases.
+   * - **Bold bullet point**: A bullet point that is entirely bolded. This point is also made lengthy to observe how the bold formatting is maintained across wrapped lines.
+   * - *Italic bullet point*: A bullet point that is entirely italicized. This final point is extended to verify that italic formatting is correctly applied even when the text spans multiple lines.
+   */
+  @scenario
+  @scenarioDoc("""
+    Test simple bullet points in documentation.
+    Expected behavior: Should render properly formatted bullet lists.
+    """)
+  @get
+  @route("/bullet-points/op")
+  op bulletPointsOp(): NoContentResponse;
+
+  /**
+   * This tests:
+   * - Simple bullet point. This bullet point is going to be very long to test how text wrapping is handled in bullet points within documentation comments. It should properly indent the wrapped lines.
+   * - Another bullet point with **bold text**. This bullet point is also intentionally long to see how the formatting is preserved when the text wraps onto multiple lines in the generated documentation.
+   * - Third bullet point with *italic text*. Similar to the previous points, this one is extended to ensure that the wrapping and formatting are correctly applied in the output.
+   * - Complex bullet point with **bold** and *italic* combined. This bullet point combines both bold and italic formatting and is long enough to test the wrapping behavior in such cases.
+   * - **Bold bullet point**: A bullet point that is entirely bolded. This point is also made lengthy to observe how the bold formatting is maintained across wrapped lines.
+   * - *Italic bullet point*: A bullet point that is entirely italicized. This final point is extended to verify that italic formatting is correctly applied even when the text spans multiple lines.
+   */
+  model BulletPointsModel {
+    /**
+     * This property uses an enum with bullet point documentation. The enum documentation includes various formatting styles to test rendering. The styles are:
+     * - Simple bullet point. This bullet point is going to be very long to test how text wrapping is handled in bullet points within documentation comments. It should properly indent the wrapped lines.
+     * - Bullet point with **bold text**. This bullet point is also intentionally long to see how the formatting is preserved when the text wraps onto multiple
+     * - Bullet point with *italic text*. Similar to the previous points, this one is extended to ensure that the wrapping and formatting are correctly applied in the output.
+     * - Complex bullet point with **bold** and *italic* combined. This bullet point combines both bold and italic formatting and is long enough to test the wrapping behavior in such cases.
+     * - **Bold bullet point**
+     * - *Italic bullet point*
+     */
+    prop: BulletPointsEnum;
+  }
+
+  /**
+   * This tests really long bullet points in enum documentation to see how wrapping and formatting are handled. This should wrap around correctly and maintain proper indentation for each line.
+   * - Simple bullet point. This bullet point is going to be very long to test how text wrapping is handled in bullet points within documentation comments. It should properly indent the wrapped lines.
+   * - Another bullet point with **bold text**. This bullet point is also intentionally long to see how the formatting is preserved when the text wraps onto multiple lines in the generated documentation.
+   * - Third bullet point with *italic text*. Similar to the previous points, this one is extended to ensure that the wrapping and formatting are correctly applied in the output.
+   * - Complex bullet point with **bold** and *italic* combined. This bullet point combines both bold and italic formatting and is long enough to test the wrapping behavior in such cases.
+   * - **Bold bullet point**: A bullet point that is entirely bolded. This point is also made lengthy to observe how the bold formatting is maintained across wrapped lines.
+   * - *Italic bullet point*: A bullet point that is entirely italicized. This final point is extended to verify that italic formatting is correctly applied even when the text spans multiple lines.
+   */
+  enum BulletPointsEnum {
+    /**
+     * Simple bullet point. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     * - One: one. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     * - Two: two. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     */
+    Simple: "Simple",
+
+    /**
+     * Bullet point with **bold text**. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     * - **One**: one. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     * - **Two**: two. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     */
+    Bold: "Bold",
+
+    /**
+     * Bullet point with *italic text*. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     * - *One*: one. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     * - *Two*: two. This line is intentionally long to test text wrapping in bullet points within enum documentation comments. It should properly indent the wrapped lines.
+     */
+    Italic: "Italic",
+  }
+
+  @scenarioDoc("""
+    Test bullet points in model and enum documentation.
+    Expected input:
+    ```json
+    {
+      "input": {"prop": "Simple"}
+    }
+    ```
+    """)
+  @post
+  @route("/bullet-points/model")
+  op bulletPointsModel(input: BulletPointsModel): OkResponse;
+
+  /**
+   * Steps to follow:
+   * 1. First step with **important** note
+   * 2. Second step with *emphasis*
+   * 3. Third step combining **bold** and *italic*
+   * 4. **Final step**: Review all steps for *accuracy*.
+   */
+  @scenario
+  @scenarioDoc("""
+    Test numbered lists.
+    Expected behavior: Should render numbered list properly.
+    """)
+  @route("/numbered")
+  @get
+  op numbered(): NoContentResponse;
+}
+
+@route("/text-formatting")
+namespace TextFormatting {
+  /**
+   * This is **bold text** in the middle of a sentence.
+   * This is a sentence with **multiple bold** sections and **another bold** section.
+   * **This entire sentence is bold.**
+   */
+  @scenario
+  @scenarioDoc("""
+    Expected behavior: Text between ** should render as bold.
+    """)
+  @route("/bold")
+  @get
+  op boldText(): NoContentResponse;
+
+  /**
+   * This is *italic text* in the middle of a sentence.
+   * This is a sentence with *multiple italic* sections and *another italic* section.
+   * *This entire sentence is italic.*
+   * */
+  @scenario
+  @scenarioDoc("""
+    Test italic text formatting using *single asterisks*.
+    Expected behavior: Text between * should render as italic.
+    """)
+  @route("/italic")
+  @get
+  op italicText(): NoContentResponse;
+
+  /**
+   * This sentence has **bold**, *italic*, and ***bold italic*** text.
+   * You can also combine them like **bold with *italic inside* bold**.
+   * Or *italic with **bold inside** italic*.
+   * This is a sentence with **bold**, *italic*, and ***bold italic*** text.
+   */
+  @scenario
+  @scenarioDoc("""
+    Test combined bold and italic formatting.
+    Expected behavior: Should handle nested and combined formatting.
+    """)
+  @route("/combined")
+  @get
+  op combinedFormatting(): NoContentResponse;
+}

package/specs/documentation/mockapi.ts

@@ -0,0 +1,59 @@
+import { json, passOnSuccess, ScenarioMockApi } from "@typespec/spec-api";
+
+export const Scenarios: Record<string, ScenarioMockApi> = {};
+
+function createGetServerTests(uri: string) {
+  return passOnSuccess({
+    uri,
+    method: "get",
+    request: {},
+    response: {
+      status: 204,
+    },
+    kind: "MockApiDefinition",
+  });
+}
+
+function createPostServerTests(uri: string, requestBody: unknown, responseBody?: unknown) {
+  return passOnSuccess({
+    uri,
+    method: "post",
+    request: {
+      body: json(requestBody),
+    },
+    response: {
+      status: 200,
+      body: responseBody ? json(responseBody) : undefined,
+    },
+    kind: "MockApiDefinition",
+  });
+}
+
+// Lists namespace tests
+Scenarios.Documentation_Lists_bulletPointsOp = createGetServerTests(
+  "/documentation/lists/bullet-points/op",
+);
+
+Scenarios.Documentation_Lists_bulletPointsModel = createPostServerTests(
+  "/documentation/lists/bullet-points/model",
+  {
+    input: {
+      prop: "Simple",
+    },
+  },
+);
+
+Scenarios.Documentation_Lists_numbered = createGetServerTests("/documentation/lists/numbered");
+
+// TextFormatting namespace tests
+Scenarios.Documentation_TextFormatting_boldText = createGetServerTests(
+  "/documentation/text-formatting/bold",
+);
+
+Scenarios.Documentation_TextFormatting_italicText = createGetServerTests(
+  "/documentation/text-formatting/italic",
+);
+
+Scenarios.Documentation_TextFormatting_combinedFormatting = createGetServerTests(
+  "/documentation/text-formatting/combined",
+);

package/specs/encode/array/main.tsp

@@ -0,0 +1,339 @@
+import "@typespec/http";
+import "@typespec/spector";
+
+using Http;
+using Spector;
+
+@doc("Test for encode decorator on array.")
+@scenarioService("/encode/array")
+namespace Encode.Array;
+
+enum Colors {
+  Blue: "blue",
+  Red: "red",
+  Green: "green",
+}
+
+union ColorsExtensibleEnum {
+  string,
+  Blue: "blue",
+  Red: "red",
+  Green: "green",
+}
+
+model CommaDelimitedArrayProperty {
+  @encode(ArrayEncoding.commaDelimited)
+  value: string[];
+}
+
+model SpaceDelimitedArrayProperty {
+  @encode(ArrayEncoding.spaceDelimited)
+  value: string[];
+}
+
+model PipeDelimitedArrayProperty {
+  @encode(ArrayEncoding.pipeDelimited)
+  value: string[];
+}
+
+model NewlineDelimitedArrayProperty {
+  @encode(ArrayEncoding.newlineDelimited)
+  value: string[];
+}
+
+model CommaDelimitedEnumArrayProperty {
+  @encode(ArrayEncoding.commaDelimited)
+  value: Colors[];
+}
+
+model SpaceDelimitedEnumArrayProperty {
+  @encode(ArrayEncoding.spaceDelimited)
+  value: Colors[];
+}
+
+model PipeDelimitedEnumArrayProperty {
+  @encode(ArrayEncoding.pipeDelimited)
+  value: Colors[];
+}
+
+model NewlineDelimitedEnumArrayProperty {
+  @encode(ArrayEncoding.newlineDelimited)
+  value: Colors[];
+}
+
+model CommaDelimitedExtensibleEnumArrayProperty {
+  @encode(ArrayEncoding.commaDelimited)
+  value: ColorsExtensibleEnum[];
+}
+
+model SpaceDelimitedExtensibleEnumArrayProperty {
+  @encode(ArrayEncoding.spaceDelimited)
+  value: ColorsExtensibleEnum[];
+}
+
+model PipeDelimitedExtensibleEnumArrayProperty {
+  @encode(ArrayEncoding.pipeDelimited)
+  value: ColorsExtensibleEnum[];
+}
+
+model NewlineDelimitedExtensibleEnumArrayProperty {
+  @encode(ArrayEncoding.newlineDelimited)
+  value: ColorsExtensibleEnum[];
+}
+
+@route("/property")
+namespace Property {
+  @route("/comma-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains a string array property with commaDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue,red,green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue,red,green"
+    }
+    ```
+    """)
+  @post
+  op commaDelimited(@body body: CommaDelimitedArrayProperty): CommaDelimitedArrayProperty;
+
+  @route("/space-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains a string array property with spaceDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue red green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue red green"
+    }
+    ```
+    """)
+  @post
+  op spaceDelimited(@body body: SpaceDelimitedArrayProperty): SpaceDelimitedArrayProperty;
+
+  @route("/pipe-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains a string array property with pipeDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue|red|green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue|red|green"
+    }
+    ```
+    """)
+  @post
+  op pipeDelimited(@body body: PipeDelimitedArrayProperty): PipeDelimitedArrayProperty;
+
+  @route("/newline-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains a string array property with newlineDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue\\nred\\ngreen"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue\\nred\\ngreen"
+    }
+    ```
+    """)
+  @post
+  op newlineDelimited(@body body: NewlineDelimitedArrayProperty): NewlineDelimitedArrayProperty;
+
+  @route("/enum/comma-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains an enum array property with commaDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue,red,green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue,red,green"
+    }
+    ```
+    """)
+  @post
+  op enumCommaDelimited(
+    @body body: CommaDelimitedEnumArrayProperty,
+  ): CommaDelimitedEnumArrayProperty;
+
+  @route("/enum/space-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains an enum array property with spaceDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue red green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue red green"
+    }
+    ```
+    """)
+  @post
+  op enumSpaceDelimited(
+    @body body: SpaceDelimitedEnumArrayProperty,
+  ): SpaceDelimitedEnumArrayProperty;
+
+  @route("/enum/pipe-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains an enum array property with pipeDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue|red|green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue|red|green"
+    }
+    ```
+    """)
+  @post
+  op enumPipeDelimited(@body body: PipeDelimitedEnumArrayProperty): PipeDelimitedEnumArrayProperty;
+
+  @route("/enum/newline-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains an enum array property with newlineDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue\\nred\\ngreen"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue\\nred\\ngreen"
+    }
+    ```
+    """)
+  @post
+  op enumNewlineDelimited(
+    @body body: NewlineDelimitedEnumArrayProperty,
+  ): NewlineDelimitedEnumArrayProperty;
+
+  @route("/extensible-enum/comma-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains an extensible enum (union) array property with commaDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue,red,green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue,red,green"
+    }
+    ```
+    """)
+  @post
+  op extensibleEnumCommaDelimited(
+    @body body: CommaDelimitedExtensibleEnumArrayProperty,
+  ): CommaDelimitedExtensibleEnumArrayProperty;
+
+  @route("/extensible-enum/space-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains an extensible enum (union) array property with spaceDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue red green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue red green"
+    }
+    ```
+    """)
+  @post
+  op extensibleEnumSpaceDelimited(
+    @body body: SpaceDelimitedExtensibleEnumArrayProperty,
+  ): SpaceDelimitedExtensibleEnumArrayProperty;
+
+  @route("/extensible-enum/pipe-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains an extensible enum (union) array property with pipeDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue|red|green"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue|red|green"
+    }
+    ```
+    """)
+  @post
+  op extensibleEnumPipeDelimited(
+    @body body: PipeDelimitedExtensibleEnumArrayProperty,
+  ): PipeDelimitedExtensibleEnumArrayProperty;
+
+  @route("/extensible-enum/newline-delimited")
+  @scenario
+  @scenarioDoc("""
+    Test operation with request and response model contains an extensible enum (union) array property with newlineDelimited encode.
+    Expected request body:
+    ```json
+    {
+      "value": "blue\\nred\\ngreen"
+    }
+    ```
+    Expected response body:
+    ```json
+    {
+      "value": "blue\\nred\\ngreen"
+    }
+    ```
+    """)
+  @post
+  op extensibleEnumNewlineDelimited(
+    @body body: NewlineDelimitedExtensibleEnumArrayProperty,
+  ): NewlineDelimitedExtensibleEnumArrayProperty;
+}

package/specs/encode/array/mockapi.ts

@@ -0,0 +1,83 @@
+import { json, passOnSuccess, ScenarioMockApi } from "@typespec/spec-api";
+
+export const Scenarios: Record<string, ScenarioMockApi> = {};
+
+const colors = ["blue", "red", "green"];
+
+function createPropertyServerTests(uri: string, delimiter: string) {
+  const encodedValue = colors.join(delimiter);
+  return passOnSuccess({
+    uri,
+    method: "post",
+    request: {
+      body: json({
+        value: encodedValue,
+      }),
+    },
+    response: {
+      status: 200,
+      body: json({ value: encodedValue }),
+    },
+    kind: "MockApiDefinition",
+  });
+}
+
+Scenarios.Encode_Array_Property_commaDelimited = createPropertyServerTests(
+  "/encode/array/property/comma-delimited",
+  ",",
+);
+
+Scenarios.Encode_Array_Property_spaceDelimited = createPropertyServerTests(
+  "/encode/array/property/space-delimited",
+  " ",
+);
+
+Scenarios.Encode_Array_Property_pipeDelimited = createPropertyServerTests(
+  "/encode/array/property/pipe-delimited",
+  "|",
+);
+
+Scenarios.Encode_Array_Property_newlineDelimited = createPropertyServerTests(
+  "/encode/array/property/newline-delimited",
+  "\n",
+);
+
+Scenarios.Encode_Array_Property_enumCommaDelimited = createPropertyServerTests(
+  "/encode/array/property/enum/comma-delimited",
+  ",",
+);
+
+Scenarios.Encode_Array_Property_enumSpaceDelimited = createPropertyServerTests(
+  "/encode/array/property/enum/space-delimited",
+  " ",
+);
+
+Scenarios.Encode_Array_Property_enumPipeDelimited = createPropertyServerTests(
+  "/encode/array/property/enum/pipe-delimited",
+  "|",
+);
+
+Scenarios.Encode_Array_Property_enumNewlineDelimited = createPropertyServerTests(
+  "/encode/array/property/enum/newline-delimited",
+  "\n",
+);
+
+Scenarios.Encode_Array_Property_extensibleEnumCommaDelimited = createPropertyServerTests(
+  "/encode/array/property/extensible-enum/comma-delimited",
+  ",",
+);
+
+Scenarios.Encode_Array_Property_extensibleEnumSpaceDelimited = createPropertyServerTests(
+  "/encode/array/property/extensible-enum/space-delimited",
+  " ",
+);
+
+Scenarios.Encode_Array_Property_extensibleEnumPipeDelimited = createPropertyServerTests(
+  "/encode/array/property/extensible-enum/pipe-delimited",
+  "|",
+);
+
+Scenarios.Encode_Array_Property_extensibleEnumNewlineDelimited = createPropertyServerTests(
+  "/encode/array/property/extensible-enum/newline-delimited",
+  "\n",
+);