@typespec/http-server-csharp 0.58.0-alpha.9 → 0.58.0-dev.1

package/dist/src/lib/boilerplate.js

@@ -3,7 +3,7 @@ export const GeneratedFileHeader = `// Generated by @typespec/http-server-csharp
 // <auto-generated />`;
 export const GeneratedFileHeaderWithNullable = `// Generated by @typespec/http-server-csharp
 // <auto-generated />
-  #nullable enable`;
+#nullable enable`;
 export function getSerializationSourceFiles(emitter) {
     const sourceFiles = [];
     sourceFiles.push(new LibrarySourceFile({
@@ -11,9 +11,9 @@ export function getSerializationSourceFiles(emitter) {
         emitter: emitter,
         getContents: getTimeSpanDurationConverter,
     }), new LibrarySourceFile({
-        filename: "Base64UrlConverter.cs",
+        filename: "Base64UrlJsonConverter.cs",
         emitter: emitter,
-        getContents: getBase64UrlConverter,
+        getContents: getBase64UrlJsonConverter,
     }), new LibrarySourceFile({
         filename: "UnixEpochDateTimeConverter.cs",
         emitter: emitter,
@@ -50,6 +50,10 @@ export function getSerializationSourceFiles(emitter) {
         filename: "JsonSerializationProvider.cs",
         emitter: emitter,
         getContents: getJsonProvider,
+    }), new LibrarySourceFile({
+        filename: "HttpServiceException.cs",
+        emitter: emitter,
+        getContents: getHttpServiceException,
     }));
     return sourceFiles;
 }
@@ -305,44 +309,52 @@ function getArrayConstraintConverter() {
 
         public override JsonConverter? CreateConverter(Type typeToConvert)
         {
-            return new ConstrainedArrayConverter<T>(_minItems, _maxItems);
+            if (typeof(ISet<T>).IsAssignableFrom(typeToConvert))
+            {
+                return new ConstrainedSetConverter<T>(_minItems, _maxItems);
+            }
+            else if (typeToConvert.IsArray && typeToConvert.GetElementType() == typeof(T))
+            {
+                return new ConstrainedStandardArrayConverter<T>(_minItems, _maxItems);
+            }
+            else 
+            {
+                return new ConstrainedEnumerableConverter<T>(_minItems, _maxItems);
+            }
         }
-
-        
     }
 
-    public class ConstrainedArrayConverter<T> : JsonConverter<T[]>
+    public abstract class ConstrainedCollectionConverter<T, TCollection> : JsonConverter<TCollection>
     {
-        public ConstrainedArrayConverter(int? min, int? max) : base()
+        protected ConstrainedCollectionConverter(int? min, int? max) 
         {
             _minItems = min;
             _maxItems = max;
         }
 
-        internal int? _minItems, _maxItems;
+        protected int? _minItems, _maxItems;
         public JsonConverter<T>? InnerConverter { get; set; }
 
-        public virtual Func<ConstrainedArrayConverter<T>, JsonSerializerOptions, JsonConverter<T>> InnerConverterFactory { get; set; } = ConverterHelpers.GetStandardInnerConverter<T>;
-
+        public virtual Func<ConstrainedCollectionConverter<T, TCollection>, JsonSerializerOptions, JsonConverter<T>> InnerConverterFactory { get; set; } = ConverterHelpers.GetStandardInnerConverter<T, TCollection>;
 
-        internal bool ValidateMin(int count)
+        protected bool ValidateMin(int count)
         {
             return !_minItems.HasValue || count >= _minItems.Value;
         }
 
-        internal bool ValidateMax(int count)
+        protected bool ValidateMax(int count)
         {
             return !_maxItems.HasValue || count <= _maxItems.Value;
         }
 
-        internal void ValidateRange(int count)
+        protected void ValidateRange(int count)
         {
             if (!ValidateMax(count) || !ValidateMin(count))
             {
                 throw new JsonException($"Number of array elements not in range [{(_minItems.HasValue ? _minItems.Value : 0)}, {(_maxItems.HasValue ? _maxItems.Value : Array.MaxLength)}]");
             }
         }
-        public override T[]? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+        public override TCollection? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
         {
             var _innerConverter = InnerConverterFactory(this, options);
             if (reader.TokenType != JsonTokenType.StartArray) { throw new JsonException("Expected start of array"); }
@@ -357,30 +369,52 @@ function getArrayConstraintConverter() {
                 count++;
             }
 
-            return list.ToArray();
-
+            return ConvertToCollection(list);
 
         }
 
-        public override void Write(Utf8JsonWriter writer, T[] value, JsonSerializerOptions options)
+        public override void Write(Utf8JsonWriter writer,  TCollection value, JsonSerializerOptions options)
         {
             var _innerConverter = InnerConverterFactory(this, options);
             writer.WriteStartArray();
-            for (int i = 0; i < value.Length; ++i)
-                _innerConverter.Write(writer, value[i], options);
+            foreach (var item in GetEnumerable(value))
+                _innerConverter.Write(writer, item, options);
             writer.WriteEndArray();
         }
+      
+        protected abstract TCollection ConvertToCollection(List<T> list);
+        protected abstract IEnumerable<T> GetEnumerable(TCollection collection);
+    }
+
+    public class ConstrainedEnumerableConverter<T> : ConstrainedCollectionConverter<T, IEnumerable<T>>
+    {
+        public ConstrainedEnumerableConverter(int? min, int? max) : base(min, max) { }
+        protected override IEnumerable<T> ConvertToCollection(List<T> list) => list;
+        protected override IEnumerable<T> GetEnumerable(IEnumerable<T> collection) => collection;
+    }
+
+    public class ConstrainedSetConverter<T> : ConstrainedCollectionConverter<T, ISet<T>>
+    {
+        public ConstrainedSetConverter(int? min, int? max) : base(min, max) { }
+        protected override ISet<T> ConvertToCollection(List<T> list) => new HashSet<T>(list);
+        protected override IEnumerable<T> GetEnumerable(ISet<T> collection) => collection;
+    }
+
+    public class ConstrainedStandardArrayConverter<T> : ConstrainedCollectionConverter<T, T[]>
+    {
+        public ConstrainedStandardArrayConverter(int? min, int? max) : base(min, max) { }
+        protected override T[] ConvertToCollection(List<T> list) => list.ToArray();
+        protected override IEnumerable<T> GetEnumerable(T[] collection) => collection;
     }
 
     internal static class ConverterHelpers
     {
-        internal static JsonConverter<T> GetStandardInnerConverter<T>(this ConstrainedArrayConverter<T> converter, JsonSerializerOptions options)
+        internal static JsonConverter<T> GetStandardInnerConverter<T, TCollection>(this ConstrainedCollectionConverter<T, TCollection> converter, JsonSerializerOptions options)
         {
             if (converter.InnerConverter == null)
             {
                 converter.InnerConverter = (JsonConverter<T>)options.GetConverter(typeof(T));
             }
-
             return converter.InnerConverter;
         }
     }
@@ -413,9 +447,23 @@ public class NumericArrayConstraintAttribute<T> : ArrayConstraintAttribute<T> wh
 
     public override JsonConverter? CreateConverter(Type typeToConvert)
     {
-        var result = base.CreateConverter(typeToConvert) as ConstrainedArrayConverter<T>;
-        if (result != null) result.InnerConverterFactory = (c, o) => new NumericJsonConverter<T>(MinValue, MaxValue, MinValueExclusive, MaxValueExclusive, o);
-        return result;
+        var result = base.CreateConverter(typeToConvert);
+        var resultSet = result as ConstrainedSetConverter<T>;
+        if (resultSet != null) { 
+            resultSet.InnerConverterFactory = (c, o) => new NumericJsonConverter<T>(MinValue, MaxValue, MinValueExclusive, MaxValueExclusive, o);
+            return resultSet;
+        }
+        var resultEnumerable = result as ConstrainedEnumerableConverter<T>;
+        if (resultEnumerable != null) { 
+            resultEnumerable.InnerConverterFactory = (c, o) => new NumericJsonConverter<T>(MinValue, MaxValue, MinValueExclusive, MaxValueExclusive, o);
+            return resultEnumerable;
+        }
+        var resultStandardArray = result as ConstrainedStandardArrayConverter<T>;
+        if (resultStandardArray != null) { 
+            resultStandardArray.InnerConverterFactory = (c, o) => new NumericJsonConverter<T>(MinValue, MaxValue, MinValueExclusive, MaxValueExclusive, o);
+            return resultStandardArray;
+        }  
+        throw new InvalidOperationException($"Cannot create converter for {typeToConvert} with {this}");    
     }
   }
 }`;
@@ -442,11 +490,27 @@ public class StringArrayConstraintAttribute : ArrayConstraintAttribute<string>
     public int MaxItemLength { get { return _maxItemLength.HasValue ? _maxItemLength.Value : 0; } set { _maxItemLength = value; } }
     public string? Pattern { get; set; }
 
-    override public JsonConverter<string[]> CreateConverter(Type typeToConvert)
+    override public JsonConverter? CreateConverter(Type typeToConvert)
     {
-        var result = base.CreateConverter(typeToConvert) as ConstrainedArrayConverter<string>;
-        result!.InnerConverterFactory = (c, o) => new StringJsonConverter(MinItemLength, MaxItemLength, Pattern, o);
-        return result;
+        var result = base.CreateConverter(typeToConvert);
+        var resultSet = result as ConstrainedSetConverter<string>;
+        if (resultSet != null) { 
+            resultSet.InnerConverterFactory = (c, o) => new StringJsonConverter(MinItemLength, MaxItemLength, Pattern, o);
+            return resultSet;
+        }
+
+        var resultEnumerable = result as ConstrainedEnumerableConverter<string>;
+        if (resultEnumerable != null) { 
+            resultEnumerable.InnerConverterFactory = (c, o) => new StringJsonConverter(MinItemLength, MaxItemLength, Pattern, o);
+            return resultEnumerable;
+        }
+
+        var resultStandardArray = result as ConstrainedStandardArrayConverter<string>;
+        if (resultStandardArray != null) { 
+            resultStandardArray.InnerConverterFactory = (c, o) => new StringJsonConverter(MinItemLength, MaxItemLength, Pattern, o);
+            return resultStandardArray;
+        }  
+        throw new InvalidOperationException($"Cannot create converter for {typeToConvert} with {this}");    
     }
 }
   }`;
@@ -463,7 +527,7 @@ function getTimeSpanDurationConverter() {
       /// <summary>
       /// Converts between Json duration and .Net TimeSpan
       /// </summary>
-      public class TimespanDurationConverter : JsonConverter<TimeSpan>
+      public class TimeSpanDurationConverter : JsonConverter<TimeSpan>
       {
           public override TimeSpan Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
           {
@@ -483,7 +547,7 @@ function getTimeSpanDurationConverter() {
   }
   `;
 }
-function getBase64UrlConverter() {
+function getBase64UrlJsonConverter() {
     return `${GeneratedFileHeaderWithNullable}
 
   using System.Text.Json;
@@ -667,4 +731,62 @@ namespace TypeSpec.Helpers
 }
 `;
 }
+function getHttpServiceException() {
+    return `${GeneratedFileHeaderWithNullable}
+
+  using Microsoft.AspNetCore.Mvc;
+  using Microsoft.AspNetCore.Mvc.Filters;
+
+  namespace TypeSpec.Helpers
+  {
+    /// <summary>
+    /// Represents an HTTP response exception with a status code and optional value.
+    /// </summary>
+    public class HttpServiceException : Exception
+    {
+      /// <summary>
+      /// Initializes a new instance of the HttpServiceException class.
+      /// </summary>
+      /// <param name="statusCode">The HTTP status code.</param>
+      /// <param name="value">The optional value to include in the response.</param>
+      public HttpServiceException(int statusCode, object? value = null, Dictionary<string, string>? headers = null) =>
+          (StatusCode, Value, Headers) = (statusCode, value, headers ?? new Dictionary<string, string>());
+
+      public int StatusCode { get; }
+
+      public object? Value { get; }
+
+      public Dictionary<string, string> Headers { get; } 
+    }
+
+    /// <summary>
+    /// An action filter that handles HttpServiceException and converts it to an HTTP response.
+    /// </summary>
+    public class HttpServiceExceptionFilter : IActionFilter, IOrderedFilter
+    {
+      public int Order => int.MaxValue - 10;
+
+      public void OnActionExecuting(ActionExecutingContext context) { }
+
+      public void OnActionExecuted(ActionExecutedContext context)
+      {
+        if (context.Exception is HttpServiceException httpServiceException)
+        {
+            foreach (var header in httpServiceException.Headers)
+            {
+                context.HttpContext.Response.Headers.Append(header.Key, header.Value.ToString());
+            }
+
+            context.Result = new ObjectResult(httpServiceException.Value)
+            {
+                StatusCode = httpServiceException.StatusCode
+            };
+
+            context.ExceptionHandled = true;
+        }
+      }
+    }
+  }
+`;
+}
 //# sourceMappingURL=boilerplate.js.map

package/dist/src/lib/boilerplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"boilerplate.js","sourceRoot":"","sources":["../../../src/lib/boilerplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG;sBACb,CAAC;AACvB,MAAM,CAAC,MAAM,+BAA+B,GAAW;;mBAEpC,CAAC;AAEpB,MAAM,UAAU,2BAA2B,CACzC,OAAoD;IAEpD,MAAM,WAAW,GAAwB,EAAE,CAAC;IAC5C,WAAW,CAAC,IAAI,CACd,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,8BAA8B;QACxC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,4BAA4B;KAC1C,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,qBAAqB;KACnC,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,+BAA+B;QACzC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,6BAA6B;KAC3C,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,qCAAqC;QAC/C,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,mCAAmC;KACjD,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,+BAA+B;QACzC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,6BAA6B;KAC3C,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,8BAA8B;QACxC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,4BAA4B;KAC1C,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,6BAA6B;QACvC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,2BAA2B;KACzC,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,mCAAmC;QAC7C,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,iCAAiC;KAC/C,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,oCAAoC;QAC9C,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,kCAAkC;KAChD,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,+BAA+B;QACzC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,wBAAwB;KACtC,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,8BAA8B;QACxC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,eAAe;KAC7B,CAAC,CACH,CAAC;IACF,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,6BAA6B;IACpC,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiGvC,CAAC;AACL,CAAC;AAED,SAAS,4BAA4B;IACnC,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsHzC,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B;IAClC,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6GvC,CAAC;AACL,CAAC;AAED,SAAS,kCAAkC;IACzC,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BzC,CAAC;AACH,CAAC;AAED,SAAS,iCAAiC;IACxC,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BvC,CAAC;AACL,CAAC;AAED,SAAS,4BAA4B;IACnC,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BxC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB;IAC5B,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCxC,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B;IACpC,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BxC,CAAC;AACJ,CAAC;AAED,SAAS,mCAAmC;IAC1C,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BxC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB;IAC/B,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B1C,CAAC;AACF,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,GAAG,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C1C,CAAC;AACF,CAAC"}
+{"version":3,"file":"boilerplate.js","sourceRoot":"","sources":["../../../src/lib/boilerplate.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/doc.d.ts

@@ -0,0 +1,5 @@
+import { AssetEmitter } from "@typespec/asset-emitter";
+import { LibrarySourceFile } from "./interfaces.js";
+import { BusinessLogicRegistrations } from "./scaffolding.js";
+export declare function getProjectDocs(emitter: AssetEmitter<string, Record<string, never>>, useSwagger: boolean, registrations?: BusinessLogicRegistrations): LibrarySourceFile[];
+//# sourceMappingURL=doc.d.ts.map

package/dist/src/lib/doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../src/lib/doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAA+B,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE3F,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EACpD,UAAU,EAAE,OAAO,EACnB,aAAa,CAAC,EAAE,0BAA0B,GACzC,iBAAiB,EAAE,CA0BrB"}

package/dist/src/lib/doc.js

@@ -0,0 +1,237 @@
+import { LibrarySourceFile } from "./interfaces.js";
+export function getProjectDocs(emitter, useSwagger, registrations) {
+    const sourceFiles = [];
+    const mocks = registrations === undefined ? [] : [...registrations.entries()].flatMap((e) => e[1]);
+    sourceFiles.push(new LibrarySourceFile({
+        filename: `README.md`,
+        emitter: emitter,
+        getContents: () => (mocks.length > 0 ? getMockReadme(mocks) : getNoMockReadme()),
+        path: ".",
+    }), new LibrarySourceFile({
+        filename: `usage.md`,
+        emitter: emitter,
+        getContents: () => getUsageDoc(),
+        path: "docs",
+    }), new LibrarySourceFile({
+        filename: `emitter.md`,
+        emitter: emitter,
+        getContents: () => getEmitterDoc(),
+        path: "docs",
+    }));
+    return sourceFiles;
+}
+function getNoMockReadme() {
+    return `---
+title: Next Steps
+---
+
+# Next Steps
+
+- Use the SwaggerUI endpoint to test out the running service
+- Implement business logic interfaces for your operations
+- Register each of your implementations as part of application startup
+- Update development and production configuration to suit your needs
+
+## More Information
+
+- See [Code Layout](docs/usage.md) for information about the generated code
+- See [Emitter Usage](docs/emitter.md) for details on how to use the emitter.
+- File issues or provide feedback in [TypeSpec Issues](https://github.com/microsoft/typespec/issues/new/choose)
+- Get information about Typespec on the [TypeSpec website](https://typespec.io)
+`;
+}
+function getUsageDoc() {
+    return `---
+title: Generated C-Sharp Overview
+---
+
+# Generated C-Sharp Overview
+
+## Layout
+
+The code layout inside the 'generated' folder is as follows:
+
+- **generated**
+
+  - **controllers**: A set of ASP.Net core MVC controllers representing the operations in the spec, one for each interface or namespace with operations
+  - **lib**: A set of library files used in implementing generated models and controllers
+  - **models**: A set of models representing the data in requests and response
+  - **operations**: A set of interfaces called by the controllers, that should be implemented with the business logic for each operation.
+
+  You should recompile whenever you make changes in your TypeSpec and these files will be replaced inline to reflect the spec changes, without changing any of your hand-written implementation in the project.
+
+## Scaffolding
+
+If you use the scaffolding cli (hscs) or use the \`--emit-mocks "mocks-and-project-files"\` option on compilation, a
+fully-functional .Net 9 project will be created with mock implementations of your business
+logic, ready to compile and run.
+
+The following additional files will be generated. It is expected that you will edit or replace these
+files as you implement your service, so you should only regenerate them when needed.
+To protect from inadvertently changing any edits you may have made to these files,
+these files will be overwritten by the emitter unless you specify the \`--overwrite\` option.
+
+- **ServiceProject.csproj**: The project file
+- **Program.cs**: Entry point that sets up the app
+- **appSettings.Development.json**: Configuration settings for the development environment
+- **appSettings.json**: Configuration settings for the production environment
+- **Properties**
+  - **launchSettings.json**: Launch configurations for the service (including local ports)
+- **mocks**: Simple implementations of business logic interfaces that return simple responses.
+  this allows testing your service out before writing any implementation code.
+
+  - **MockRegistration.cs**: Called from the Program.cs startup, registers each of the business
+    logic implementations in the dependency injection container.
+  - **IInitializer.cs**: Interface used in the mocks to create responses.
+  - **Initializer.cs**: Implementation of the interface to create mock responses.
+
+## SwaggerUI
+
+If you include the \`@typespec/openapi3\` emitter in your typespec project, you can include a
+SwaggerUI endpoint in the generated service using the \`--use-swaggerui\` option. This endpoint
+provides a visual representation of operations and provides a web GUI client connected to the service that you can use right away to try out service operations.
+
+## How Components Work Together
+
+### Controllers
+
+The generated controllers automatically listen at the routes you specified in TypeSpec. Controllers perform validation of input requests, call your implementation of business logic interfaces to perform the operation, and return the appropriate Http response.
+
+### Business Logic Interfaces
+
+You must implement business loginc interfaces to perform the work of each operation. There is one
+business logic interface for each \`interface\` type in your spec, or for each namespace that contain operations. Business logic can assume that input types meet the constraints specified in TypeSpec and are responsible for returning the response type for the operation.
+
+You can use the \`--emit-mocks\` option to emit mock implementations of your business logic, these mocks demonstrate a simple implementation that returns responses that match the response type in TypeSpec. They also show how to use \`IHttpContextAccessor\` to access additional details of the Http request and response.
+
+### Discovery using the ASP.Net Core Dependency Injection Container
+
+The Controllers find your business logic implementation through the ASP.Net dependency injection container. At server start, you register each of your implementations with the dependency injection container and they will automatically be instantiated and used by the controllers.
+
+If you use the \`--emit-mocks\` option, sample code registering mock implementations is emitted to \`mocks/MockRegistration.cs\`.
+
+### Models
+
+Model classes represent the data passed in Http requests and response and the data that passes from the front end controllers to your business logic.
+
+Models are partial, so you can add additional members for internal usage as needed by putting a partial class definition with additional members outside the \`generated\` folder in your project.
+
+### Next Steps
+
+After successful generation, you should:
+
+- Use the SwaggerUI endpoint to test out the running service
+- Implement the business logic interfaces for your operations
+- Update MockRegistration.cs, or register each of your interfaces as part of application startup
+- Update configuration to suit your needs
+`;
+}
+function getEmitterDoc() {
+    return `---
+title: "Emitter usage"
+---
+
+# Emitter Usage
+
+1. Via the command line
+
+\`\`\`bash
+tsp compile . --emit=@typespec/http-server-csharp
+\`\`\`
+
+2. Via the config
+
+\`\`\`yaml
+emit:
+  - "@typespec/http-server-csharp"
+\`\`\`
+
+The config can be extended with options as follows:
+
+\`\`\`yaml
+emit:
+  - "@typespec/http-server-csharp"
+options:
+  "@typespec/http-server-csharp":
+    option: value
+\`\`\`
+
+## Emitter options
+
+### \`skip-format\`
+
+**Type:** \`boolean\`
+
+Skips formatting of generated C# Types. By default, C# files are formatted using 'dotnet format'.
+
+### \`output-type\`
+
+**Type:** \`"models" | "all"\`
+
+Chooses which service artifacts to emit. choices include 'models' or 'all' artifacts.
+
+### \`emit-mocks\`
+
+**Type:** \`"mocks-and-project-files" | "mocks-only" | "none"\`
+
+Emits mock implementations of business logic, setup code, and project files enabling the service to respond to requests before a real implementation is provided
+
+### \`use-swaggerui\`
+
+**Type:** \`boolean\`
+
+Configure a Swagger UI endpoint in the development configuration
+
+### \`openapi-path\`
+
+**Type:** \`string\`
+
+Use openapi at the given path for generating SwaggerUI endpoints. By default, this will be 'openapi/openapi.yaml' if the 'use-swaggerui' option is enabled.
+
+### \`overwrite\`
+
+**Type:** \`boolean\`
+
+When generating mock files, setup code, and project files overwrite any existing files with the same name.
+
+### \`project-name\`
+
+**Type:** \`string\`
+
+The name of the generated project.
+
+### \`http-port\`
+
+**Type:** \`number\`
+
+The service http port when hosting the project locally.
+
+### \`https-port\`
+
+**Type:** \`number\`
+
+The service https port when hosting the project locally.
+`;
+}
+function getMockReadme(mocks) {
+    return `---
+title: Next Steps
+---
+
+# Next Steps
+
+- Use the SwaggerUI endpoint to test out the running service
+- Update business logic mocks with real business logic
+${mocks.flatMap((m) => `  - \`mocks/${m.className}.cs\``).join("\n")}
+- Update \`mocks/MockRegistration.cs\` if you update the constructor of business logic implementations.
+- Update development and production configuration to suit your needs
+
+## More Information
+
+- See [Code Layout](docs/usage.md) for information about the generated code
+- See [Emitter Usage](docs/emitter.md) for details on how to use the emitter.
+- File issues or provide feedback in [TypeSpec Issues](https://github.com/microsoft/typespec/issues/new/choose)
+- Get information about Typespec on the [TypeSpec website](https://typespec.io)
+`;
+}
+//# sourceMappingURL=doc.js.map

package/dist/src/lib/doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc.js","sourceRoot":"","sources":["../../../src/lib/doc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,UAAU,cAAc,CAC5B,OAAoD,EACpD,UAAmB,EACnB,aAA0C;IAE1C,MAAM,WAAW,GAAwB,EAAE,CAAC;IAC5C,MAAM,KAAK,GACT,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,WAAW,CAAC,IAAI,CACd,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;QAChF,IAAI,EAAE,GAAG;KACV,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;QAChC,IAAI,EAAE,MAAM;KACb,CAAC,EACF,IAAI,iBAAiB,CAAC;QACpB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;QAClC,IAAI,EAAE,MAAM;KACb,CAAC,CACH,CAAC;IAEF,OAAO,WAAW,CAAC;AACrB,CAAC;AACD,SAAS,eAAe;IACtB,OAAO;;;;;;;;;;;;;;;;;CAiBR,CAAC;AACF,CAAC;AAED,SAAS,WAAW;IAClB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFR,CAAC;AACF,CAAC;AAED,SAAS,aAAa;IACpB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFR,CAAC;AACF,CAAC;AACD,SAAS,aAAa,CAAC,KAAoC;IACzD,OAAO;;;;;;;;EAQP,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;CAUnE,CAAC;AACF,CAAC"}

package/dist/src/lib/interfaces.d.ts

@@ -1,6 +1,8 @@
-import { Model } from "@typespec/compiler";
-import { AssetEmitter, Context, EmittedSourceFile, EmitterOutput, Scope, SourceFile } from "@typespec/compiler/emitter-framework";
+import { AssetEmitter, Context, EmittedSourceFile, EmitterOutput, Scope, SourceFile } from "@typespec/asset-emitter";
+import type { Model } from "@typespec/compiler";
 import { HttpStatusCodeRange } from "@typespec/http";
+import { HttpRequestParameterKind } from "@typespec/http/experimental/typekit";
+import { CSharpServiceEmitterOptions } from "./lib.js";
 export declare const HelperNamespace: string;
 export interface CSharpTypeMetadata {
     name: string;
@@ -17,17 +19,45 @@ export declare class CSharpType implements CSharpTypeMetadata {
     isBuiltIn: boolean;
     isValueType: boolean;
     isNullable: boolean;
+    isClass: boolean;
+    isCollection: boolean;
     constructor(input: {
         name: string;
         namespace: string;
         isBuiltIn?: boolean;
         isValueType?: boolean;
         isNullable?: boolean;
+        isClass?: boolean;
+        isCollection?: boolean;
     });
     isNamespaceInScope(scope?: Scope<string>, visited?: Set<Scope<string>>): boolean;
     getTypeReference(scope?: Scope<string>): string;
     equals(other: CSharpType | undefined): boolean;
 }
+export declare function checkOrAddNamespaceToScope(ns: string, scope?: Scope<string>, visited?: Set<Scope<string>>): boolean;
+export declare enum CollectionType {
+    ISet = "ISet",
+    ICollection = "ICollection",
+    IEnumerable = "IEnumerable",
+    Array = "[]"
+}
+export declare function resolveCollectionType(option?: string): CollectionType;
+export declare class CSharpCollectionType extends CSharpType {
+    collectionType: CollectionType;
+    itemTypeName: string;
+    static readonly implementationType: Record<CollectionType, string>;
+    constructor(csharpType: {
+        name: string;
+        namespace: string;
+        isBuiltIn?: boolean;
+        isValueType?: boolean;
+        isNullable?: boolean;
+        isClass?: boolean;
+        isCollection?: boolean;
+    }, collectionType: CollectionType, itemTypeName: string);
+    getTypeReference(scope?: Scope<string> | undefined): string;
+    getImplementationType(): string;
+}
 export declare abstract class CSharpValue {
     value?: any;
     abstract emitValue(scope?: Scope<string>): string;
@@ -99,7 +129,7 @@ export declare class CSharpController extends CSharpDeclaration {
     getDeclaration(scope: Scope<string>): EmitterOutput<string>;
 }
 export interface ControllerContext extends Context {
-    file: SourceFile<string>;
+    namespace: string;
     resourceName: string;
     resourceType?: Model;
     scope: Scope<string>;
@@ -128,12 +158,26 @@ export declare class LibrarySourceFile {
     constructor(params: {
         filename: string;
         getContents: () => string;
-        emitter: AssetEmitter<string, Record<string, never>>;
+        emitter: AssetEmitter<string, CSharpServiceEmitterOptions>;
         path?: string;
+        conditional?: boolean;
     });
+    conditional: boolean;
     filename: string;
     source: SourceFile<string>;
     emitted: EmittedSourceFile;
     path: string;
 }
+export interface CSharpOperationParameter {
+    name: string;
+    typeName: EmitterOutput<string>;
+    optional: boolean;
+    httpParameterKind: HttpRequestParameterKind;
+    httpParameterName?: string;
+    callName: string;
+    isExplicitBody: boolean;
+    nullable: boolean;
+    operationKind: "Http" | "BusinessLogic" | "All";
+    defaultValue?: string | boolean;
+}
 //# sourceMappingURL=interfaces.d.ts.map