@typespec/http-server-csharp 0.58.0-alpha.28 → 0.58.0-alpha.29-dev.3

package/dist/src/components/render-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-root.d.ts","sourceRoot":"","sources":["../../../src/components/render-root.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAOrF,MAAM,WAAW,6BAA6B;IAC5C,0FAA0F;IAC1F,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,4DAA4D;IAC5D,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,6BAA6B,EAAE,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,QAAQ,CAmGvF"}

package/dist/src/components/render-root.js

@@ -0,0 +1,122 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { For, SourceDirectory } from "@alloy-js/core";
+import * as cs from "@alloy-js/csharp";
+import { Namespace } from "@alloy-js/csharp";
+import { useEmitterOptions } from "../context/emitter-options-context.js";
+import { Controller } from "./controllers/controllers.js";
+import { CSharpFile } from "./csharp-file.js";
+import { BusinessLogicInterface } from "./interfaces/interfaces.js";
+import { RequestModels } from "./request-models.js";
+/**
+ * Component that renders controllers and their corresponding business logic interfaces.
+ */
+export function ControllersAndInterfaces(props) {
+  const namePolicy = cs.useCSharpNamePolicy();
+  const {
+    serviceNamespace: parentNamespace
+  } = useEmitterOptions();
+  const interfaceOps = props.interfaces.map(iface => ({
+    iface,
+    ops: props.canonicalOpsMap.get(iface.name) ?? []
+  }));
+
+  // Collect operations that need request model classes
+  const requestModels = [];
+  for (const {
+    iface,
+    ops
+  } of interfaceOps) {
+    for (const op of ops) {
+      // GET requests don't have body parameters in the server
+      if (op.method === "get") continue;
+      const body = op.requestParameters.body;
+      if (body?.bodyKind === "single" && body.bodies.length > 0) {
+        const bodyType = body.bodies[0].type.sourceType;
+        // Create request model for body parameters that have properties to decompose
+        // This handles spread params (...Model) and implicit body models
+        if (bodyType.kind === "Model" && bodyType.properties.size > 0) {
+          // Skip if the body has an explicit property (i.e., @body/@bodyRoot decorator used)
+          const hasExplicitBody = body.bodies[0].property !== undefined;
+          if (!hasExplicitBody) {
+            const opName = namePolicy.getName(op.name, "class-method");
+            const requestModelName = `${iface.name}${opName}Request`;
+            requestModels.push({
+              name: requestModelName,
+              op,
+              ifaceName: iface.name
+            });
+          }
+        }
+      }
+    }
+  }
+  return [_$createComponent(SourceDirectory, {
+    path: "models",
+    get children() {
+      return _$createComponent(RequestModels, {
+        requestModels: requestModels
+      });
+    }
+  }), _$createComponent(SourceDirectory, {
+    path: "operations",
+    get children() {
+      return _$createComponent(For, {
+        each: interfaceOps,
+        children: ({
+          iface,
+          ops
+        }) => {
+          const hasMultipart = ops.some(op => op.requestParameters.body?.bodyKind === "multipart");
+          return _$createComponent(CSharpFile, {
+            get path() {
+              return `I${iface.name}.cs`;
+            },
+            get using() {
+              return ["System", "System.Collections.Generic", "System.Text.Json", "System.Text.Json.Nodes", "System.Text.Json.Serialization", "System.Threading.Tasks", ...(hasMultipart ? ["Microsoft.AspNetCore.WebUtilities"] : [])];
+            },
+            get children() {
+              return _$createComponent(BusinessLogicInterface, {
+                type: iface,
+                canonicalOps: ops
+              });
+            }
+          });
+        }
+      });
+    }
+  }), _$createComponent(SourceDirectory, {
+    path: "controllers",
+    get children() {
+      return _$createComponent(Namespace, {
+        name: "Controllers",
+        get children() {
+          return _$createComponent(For, {
+            each: interfaceOps,
+            children: ({
+              iface,
+              ops
+            }) => {
+              const hasMultipart = ops.some(op => op.requestParameters.body?.bodyKind === "multipart");
+              return _$createComponent(CSharpFile, {
+                get path() {
+                  return `${iface.name}Controller.cs`;
+                },
+                get using() {
+                  return ["System", "System.Net", "System.Threading.Tasks", "System.Text.Json", "System.Text.Json.Nodes", "System.Text.Json.Serialization", ...(hasMultipart ? ["Microsoft.AspNetCore.WebUtilities", "Microsoft.AspNetCore.Http.Extensions"] : []), ...(parentNamespace ? [parentNamespace] : [])];
+                },
+                get children() {
+                  return _$createComponent(Controller, {
+                    type: iface,
+                    operations: ops,
+                    requestModels: requestModels
+                  });
+                }
+              });
+            }
+          });
+        }
+      });
+    }
+  })];
+}
+//# sourceMappingURL=render-root.js.map

package/dist/src/components/render-root.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["For","SourceDirectory","cs","Namespace","useEmitterOptions","Controller","CSharpFile","BusinessLogicInterface","RequestModels","ControllersAndInterfaces","props","namePolicy","useCSharpNamePolicy","serviceNamespace","parentNamespace","interfaceOps","interfaces","map","iface","ops","canonicalOpsMap","get","name","requestModels","op","method","body","requestParameters","bodyKind","bodies","length","bodyType","type","sourceType","kind","properties","size","hasExplicitBody","property","undefined","opName","getName","requestModelName","push","ifaceName","_$createComponent","path","children","each","hasMultipart","some","using","canonicalOps","operations"],"sources":["../../../src/components/render-root.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/components/request-models.d.ts

@@ -0,0 +1,15 @@
+import { type Children } from "@alloy-js/core";
+import type { OperationHttpCanonicalization } from "@typespec/http-canonicalization";
+export interface RequestModelInfo {
+    name: string;
+    op: OperationHttpCanonicalization;
+    ifaceName: string;
+}
+export interface RequestModelsProps {
+    requestModels: RequestModelInfo[];
+}
+/**
+ * Generates request model classes for operations with unnamed body types.
+ */
+export declare function RequestModels(props: RequestModelsProps): Children;
+//# sourceMappingURL=request-models.d.ts.map

package/dist/src/components/request-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-models.d.ts","sourceRoot":"","sources":["../../../src/components/request-models.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAKpD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAMrF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,6BAA6B,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ,CAsBjE"}

package/dist/src/components/request-models.js

@@ -0,0 +1,97 @@
+import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { For } from "@alloy-js/core";
+import * as cs from "@alloy-js/csharp";
+import { Attribute } from "@alloy-js/csharp";
+import { isVoidType } from "@typespec/compiler";
+import { useTsp } from "@typespec/emitter-framework";
+import { JsonSerialization } from "../utils/csharp-libs.js";
+import { getDocComments } from "../utils/doc-comments.js";
+import { CSharpFile } from "./csharp-file.js";
+import { TypeExpression } from "./type-expression/type-expression.js";
+const requestModelUsings = ["System", "System.Text.Json", "System.Text.Json.Nodes", "TypeSpec.Helpers", "TypeSpec.Helpers.JsonConverters"];
+/**
+ * Generates request model classes for operations with unnamed body types.
+ */
+export function RequestModels(props) {
+  return _$createComponent(For, {
+    get each() {
+      return props.requestModels;
+    },
+    children: rm => {
+      const body = rm.op.requestParameters.body;
+      if (!body || body.bodyKind !== "single" || body.bodies.length === 0) return undefined;
+      const bodyType = body.bodies[0].type.sourceType;
+      if (bodyType.kind !== "Model") return undefined;
+      const properties = Array.from(bodyType.properties.entries()).filter(([_, p]) => !isVoidType(p.type));
+      return _$createComponent(CSharpFile, {
+        get path() {
+          return `${rm.name}.cs`;
+        },
+        using: requestModelUsings,
+        get children() {
+          return _$createComponent(RequestModelClass, {
+            get name() {
+              return rm.name;
+            },
+            properties: properties
+          });
+        }
+      });
+    }
+  });
+}
+function RequestModelClass(props) {
+  const {
+    $
+  } = useTsp();
+  const namePolicy = cs.useCSharpNamePolicy();
+  return _$createComponent(cs.ClassDeclaration, {
+    get name() {
+      return props.name;
+    },
+    "public": true,
+    partial: true,
+    get children() {
+      return _$createComponent(For, {
+        get each() {
+          return props.properties;
+        },
+        doubleHardline: true,
+        children: ([_, property]) => {
+          const propName = namePolicy.getName(property.name, "class-property");
+          const attrs = [];
+          if (propName !== property.name) {
+            attrs.push(_$createComponent(Attribute, {
+              get name() {
+                return JsonSerialization.JsonPropertyNameAttribute;
+              },
+              get args() {
+                return [`"${property.name}"`];
+              }
+            }));
+          }
+          return _$createComponent(cs.Property, {
+            name: propName,
+            get type() {
+              return _$createComponent(TypeExpression, {
+                get type() {
+                  return property.type;
+                }
+              });
+            },
+            "public": true,
+            get: true,
+            set: true,
+            get doc() {
+              return getDocComments($, property);
+            },
+            get attributes() {
+              return attrs.length > 0 ? attrs : undefined;
+            }
+          });
+        }
+      });
+    }
+  });
+}
+//# sourceMappingURL=request-models.js.map

package/dist/src/components/request-models.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["For","cs","Attribute","isVoidType","useTsp","JsonSerialization","getDocComments","CSharpFile","TypeExpression","requestModelUsings","RequestModels","props","_$createComponent","each","requestModels","children","rm","body","op","requestParameters","bodyKind","bodies","length","undefined","bodyType","type","sourceType","kind","properties","Array","from","entries","filter","_","p","path","name","using","RequestModelClass","$","namePolicy","useCSharpNamePolicy","ClassDeclaration","partial","doubleHardline","property","propName","getName","attrs","push","JsonPropertyNameAttribute","args","Property","get","set","doc","attributes"],"sources":["../../../src/components/request-models.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/components/scaffolding/documentation.d.ts

@@ -0,0 +1,12 @@
+import { type Children } from "@alloy-js/core";
+export interface DocumentationProps {
+    /** Names of interfaces with mock implementations. */
+    interfaceNames: string[];
+    /** Whether SwaggerUI is enabled. */
+    useSwaggerUI?: boolean;
+}
+/**
+ * Renders documentation files: README.md, docs/usage.md, docs/emitter.md.
+ */
+export declare function Documentation(props: DocumentationProps): Children;
+//# sourceMappingURL=documentation.d.ts.map

package/dist/src/components/scaffolding/documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.d.ts","sourceRoot":"","sources":["../../../../src/components/scaffolding/documentation.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ,CAmBjE"}

package/dist/src/{lib/doc.js → components/scaffolding/documentation.js}

@@ -1,27 +1,36 @@
-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;
+import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { SourceDirectory, SourceFile } from "@alloy-js/core";
+/**
+ * Renders documentation files: README.md, docs/usage.md, docs/emitter.md.
+ */
+export function Documentation(props) {
+  const hasMocks = props.interfaceNames.length > 0;
+  const readme = hasMocks ? getMockReadme(props.interfaceNames) : getNoMockReadme();
+  return [_$createComponent(SourceFile, {
+    filetype: "md",
+    path: "README.md",
+    children: readme
+  }), _$createComponent(SourceDirectory, {
+    path: "docs",
+    get children() {
+      return [_$createComponent(SourceFile, {
+        filetype: "md",
+        path: "usage.md",
+        get children() {
+          return getUsageDoc();
+        }
+      }), _$createComponent(SourceFile, {
+        filetype: "md",
+        path: "emitter.md",
+        get children() {
+          return getEmitterDoc();
+        }
+      })];
+    }
+  })];
 }
 function getNoMockReadme() {
-    return `---
+  return `---
 title: Next Steps
 ---
 
@@ -34,6 +43,28 @@ title: Next Steps
 
 ## 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 getMockReadme(interfaceNames) {
+  const mockLines = interfaceNames.map(name => `  - \`mocks/${name}.cs\``).join("\n");
+  return `---
+title: Next Steps
+---
+
+# Next Steps
+
+- Use the SwaggerUI endpoint to test out the running service
+- Update business logic mocks with real business logic
+${mockLines}
+- 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)
@@ -41,7 +72,7 @@ title: Next Steps
 `;
 }
 function getUsageDoc() {
-    return `---
+  return `---
 title: Generated C-Sharp Overview
 ---
 
@@ -127,7 +158,7 @@ After successful generation, you should:
 `;
 }
 function getEmitterDoc() {
-    return `---
+  return `---
 title: "Emitter usage"
 ---
 
@@ -213,25 +244,4 @@ The service http port when hosting the project locally.
 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
+//# sourceMappingURL=documentation.js.map

package/dist/src/components/scaffolding/documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SourceDirectory","SourceFile","Documentation","props","hasMocks","interfaceNames","length","readme","getMockReadme","getNoMockReadme","_$createComponent","filetype","path","children","getUsageDoc","getEmitterDoc","mockLines","map","name","join"],"sources":["../../../../src/components/scaffolding/documentation.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,eAAe,EAAEC,UAAU,QAAuB,gBAAgB;AAS3E;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,KAAyB,EAAY;EACjE,MAAMC,QAAQ,GAAGD,KAAK,CAACE,cAAc,CAACC,MAAM,GAAG,CAAC;EAChD,MAAMC,MAAM,GAAGH,QAAQ,GAAGI,aAAa,CAACL,KAAK,CAACE,cAAc,CAAC,GAAGI,eAAe,CAAC,CAAC;EAEjF,QAAAC,iBAAA,CAEKT,UAAU;IAACU,QAAQ;IAAMC,IAAI;IAAAC,QAAA,EAC3BN;EAAM,IAAAG,iBAAA,CAERV,eAAe;IAACY,IAAI;IAAA,IAAAC,SAAA;MAAA,QAAAH,iBAAA,CAClBT,UAAU;QAACU,QAAQ;QAAMC,IAAI;QAAA,IAAAC,SAAA;UAAA,OAC3BC,WAAW,CAAC,CAAC;QAAA;MAAA,IAAAJ,iBAAA,CAEfT,UAAU;QAACU,QAAQ;QAAMC,IAAI;QAAA,IAAAC,SAAA;UAAA,OAC3BE,aAAa,CAAC,CAAC;QAAA;MAAA;IAAA;EAAA;AAK1B;AAEA,SAASN,eAAeA,CAAA,EAAW;EACjC,OAAO;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AACD;AAEA,SAASD,aAAaA,CAACH,cAAwB,EAAU;EACvD,MAAMW,SAAS,GAAGX,cAAc,CAACY,GAAG,CAAEC,IAAI,IAAK,eAAeA,IAAI,OAAO,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC;EACrF,OAAO;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAEH,SAAS;AACX;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AACD;AAEA,SAASF,WAAWA,CAAA,EAAW;EAC7B,OAAO;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AACD;AAEA,SAASC,aAAaA,CAAA,EAAW;EAC/B,OAAO;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AACD","ignoreList":[]}

package/dist/src/components/scaffolding/mock-helpers.d.ts

@@ -0,0 +1,10 @@
+import { type Children } from "@alloy-js/core";
+export interface MockHelpersProps {
+    interfaceRegistrations: string[];
+}
+/**
+ * Renders the mock helper files: IInitializer, Initializer, MockRegistration.
+ * These go under the TypeSpec.Helpers namespace.
+ */
+export declare function MockHelpers(props: MockHelpersProps): Children;
+//# sourceMappingURL=mock-helpers.d.ts.map

package/dist/src/components/scaffolding/mock-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/scaffolding/mock-helpers.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI5E,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,QAAQ,CAY7D"}