Multipart explicit parts

.vscode/settings.json

@@ -10,6 +10,7 @@
     "**/node_modules/**": true,
     "packages/compiler/templates/__snapshots__/**": true,
     "packages/website/versioned_docs/**": true,
+    "packages/http-client-csharp/**/Generated/**": true,
     "packages/samples/scratch/**": false // Those files are in gitignore but we still want to search for them
   },
   "files.exclude": {

packages/http/generated-defs/TypeSpec.Http.Private.ts

@@ -1,3 +1,12 @@
-import type { DecoratorContext, Model } from "@typespec/compiler";
+import type { DecoratorContext, Model, Type } from "@typespec/compiler";
 
 export type PlainDataDecorator = (context: DecoratorContext, target: Model) => void;
+
+export type HttpFileDecorator = (context: DecoratorContext, target: Model) => void;
+
+export type HttpPartDecorator = (
+  context: DecoratorContext,
+  target: Model,
+  type: Type,
+  options: unknown
+) => void;

packages/http/generated-defs/TypeSpec.Http.ts

@@ -111,6 +111,23 @@ export type BodyRootDecorator = (context: DecoratorContext, target: ModelPropert
  */
 export type BodyIgnoreDecorator = (context: DecoratorContext, target: ModelProperty) => void;
 
+/**
+ *
+ *
+ *
+ * @example
+ * ```tsp
+ * op upload(
+ * @header `content-type`: "multipart/form-data",
+ * @multipartBody body: {
+ * fullName: HttpPart<string>,
+ * headShots: HttpPart<Image>[]
+ * }
+ * ): void;
+ * ```
+ */
+export type MultipartBodyDecorator = (context: DecoratorContext, target: ModelProperty) => void;
+
 /**
  * Specify the HTTP verb for the target operation to be `GET`.
  *

packages/http/generated-defs/TypeSpec.Http.ts-test.ts

@@ -8,6 +8,7 @@ import {
   $head,
   $header,
   $includeInapplicableMetadataInPayload,
+  $multipartBody,
   $patch,
   $path,
   $post,
@@ -28,6 +29,7 @@ import type {
   HeadDecorator,
   HeaderDecorator,
   IncludeInapplicableMetadataInPayloadDecorator,
+  MultipartBodyDecorator,
   PatchDecorator,
   PathDecorator,
   PostDecorator,
@@ -48,6 +50,7 @@ type Decorators = {
   $path: PathDecorator;
   $bodyRoot: BodyRootDecorator;
   $bodyIgnore: BodyIgnoreDecorator;
+  $multipartBody: MultipartBodyDecorator;
   $get: GetDecorator;
   $put: PutDecorator;
   $post: PostDecorator;
@@ -70,6 +73,7 @@ const _: Decorators = {
   $path,
   $bodyRoot,
   $bodyIgnore,
+  $multipartBody,
   $get,
   $put,
   $post,

packages/http/lib/http-decorators.tsp → packages/http/lib/decorators.tsp

@@ -122,6 +122,21 @@ extern dec bodyRoot(target: ModelProperty);
  */
 extern dec bodyIgnore(target: ModelProperty);
 
+/**
+ * @example
+ *
+ * ```tsp
+ * op upload(
+ *   @header `content-type`: "multipart/form-data",
+ *   @multipartBody body: {
+ *     fullName: HttpPart<string>,
+ *     headShots: HttpPart<Image>[]
+ *   }
+ * ): void;
+ * ```
+ */
+extern dec multipartBody(target: ModelProperty);
+
 /**
  * Specify the status code for this response. Property type must be a status code integer or a union of status code integer.
  *
@@ -291,10 +306,3 @@ extern dec route(
  * ```
  */
 extern dec sharedRoute(target: Operation);
-
-/**
- * Private decorators. Those are meant for internal use inside Http types only.
- */
-namespace Private {
-  extern dec plainData(target: TypeSpec.Reflection.Model);
-}

packages/http/lib/http.tsp

@@ -1,5 +1,6 @@
 import "../dist/src/index.js";
-import "./http-decorators.tsp";
+import "./decorators.tsp";
+import "./private.decorators.tsp";
 import "./auth.tsp";
 
 namespace TypeSpec.Http;
@@ -104,3 +105,18 @@ model ConflictResponse is Response<409>;
 model PlainData<Data> {
   ...Data;
 }
+
+@Private.httpFile
+model File {
+  contentType?: string;
+  filename?: string;
+  contents: bytes;
+}
+
+model HttpPartOptions {
+  /** Name of the part when using the array form. */
+  name?: string;
+}
+
+@Private.httpPart(Type, Options)
+model HttpPart<Type, Options extends valueof HttpPartOptions = #{}> {}

packages/http/lib/private.decorators.tsp

@@ -0,0 +1,14 @@
+import "../dist/src/private.decorators.js";
+
+/**
+ * Private decorators. Those are meant for internal use inside Http types only.
+ */
+namespace TypeSpec.Http.Private;
+
+extern dec plainData(target: TypeSpec.Reflection.Model);
+extern dec httpFile(target: TypeSpec.Reflection.Model);
+extern dec httpPart(
+  target: TypeSpec.Reflection.Model,
+  type: unknown,
+  options: valueof HttpPartOptions
+);